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Code Club is a nationwide network of volunteer-led after school clubs 
for children aged 9-11. 


We're always looking for people with coding skills to volunteer to run 
a Club at their local primary school, library or community centre for an 
hour a week. 


You can team up with colleagues, a teacher will be there to support 
you and we provide all the materials you'll need to help get children 
excited about digital making. 


There are loads of ways to get involved! 


So to find out more, join us at www.codeclub.org.uk 


WELCOME TO 
THE OFFICIAL 
MAGAZINE 


t’s been extremely hard to keep the 
existence of the Pi Zero W secret over 
the last few months. When Eben Upton 
first revealed that he had something new in the 
pipeline, we spent the rest of the day discussing 
how much of a game-changer it could be for 
hackers and makers around the world. 
Now that the wireless connectivity of the 
Pi Zero W has been revealed, you can find 
the definitive breakdown — including some 
background into its making — starting on 
page 64. And beginning on page 14, this 
month’s big build integrates the new Pi model 
with Adafruit’s amazing PiGRRL handheld 
console, making it even better than before. 
To celebrate even further, we’ve got a new 
subscription offer that lets you walk away 
with your own Pi Zero W and brand-new 
official Pi Zero case that comes with three 
interchangeable covers. You’ll also get cables 
for the Camera Module, HDMI, and USB ports. 
Learn more on page 28. Enjoy the issue! 


Rob Zwetsloot 
Features Editor 
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PI ZERO W 
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CREATES 


CURRICULUM 


New curriculum aims to teach the power of digital making 


6 


Teachers 

can use the 
curriculum to 
develop their skills 
and as inspiration 
for school lessons 


he Raspberry Pi 
Foundation is determined 
to put the power of digital 
making into the hands of people 
all over the world. 
It has taken an exciting step 
in this journey, by defining its 
digital making curriculum that 
will help people everywhere learn 
new skills. 


You can view the new curriculum 


online (magpi.cc/2kZD18)}). 


For the community 
“We have a large and diverse 
community of people who are 
interested in digital making,” 
explains Carrie Anne Philbin, 
director of education at the 
Raspberry Pi Foundation. 
Some of those people 
might use the curriculum to 
help guide and inform their 
learning, or perhaps their 
children’s education. 


Individuals who run digital 
making clubs at schools, 
community centres, and 
Raspberry Jams may draw 
on it for extra guidance. 

Some teachers may wish to use 
the curriculum as inspiration for 
what to teach their students. 

“We want to help people to 
make things so that they can 
become the inventors, creators, 
and makers of tomorrow,” says 
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The Raspberry Pi Foundation is 


proud to be part of the maker 


movement. It is Looking for 
feedback from the community 
on its new curriculum. 

Please add your feedback to 
this form: magpi.cc/2kKfQ3e. 
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RASPBERRY PICURRICULUM [@/277)) 


Maker 


° ~ 
. 


z 


Design basic 2D and 
3D assets. 


Combine 2D and 3D 
assets in the assembly 
of a project 


Use multiple designed 
assets in completed 
products and models 


Design multiple and 
integrating assets for 
use in complex finished 
projects and models 


constructs to create 
simple programs 


Use basic programming 


Combine programming 
constructs to solve 
a problem 


Apply abstraction and 
decomposition to solve 
more complex problems 


Apply higher-order 
programming techniques 
to solve real-world 
problems 


components 


Use basic digital, analogue, 
and electromechanical 


Combine inputs and/or 
outputs to create projects 
or solve a problem 


Process input data to 
monitor or react to the 
environment. 


Create automated systems 
to solve complex real-world 
problems 


prototypes 


Use basic materials and 
tools to create project 


Use manufacturing 
techniques and tools to 
create prototype projects 


Use manufacturing 
techniques and tools to 
create a completed product 


Independently use fabrication 
systems to produce complex 
finished projects 


the digital making 
community 


Carrie Anne. Digital making, 
STEAM, project-based learning 
and tinkering are at the core of the 
Foundation’s teaching philosophy. 
This principle can be summed up 
simply as “we learn best by doing,” 
Carrie Anne tells us. 


The curriculum 
The curriculum has five strands: 
Design, Programming, Physical 
Computing, Manufacture, and 
Community and Sharing. Each of 
these encapsulates key concepts 
and skills in digital making. Users 
will progress in each strand. “You 
start with certain skills and 
knowledge,” says Carrie Anne. 
Then, with guidance, practice, 
and understanding, you progress 
towards broader and deeper 
knowledge and competence. 
Characters are used to represent 
different levels of ability. 
Progression starts with Creator, 
and moves onto Builder and 
Developer before becoming Maker. 
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Engage and share with 


Collaborate on digital 
making projects with 
other community members 


Support others in the 
design and construction of 
their digital making projects 


Support others in the 
design and construction of 
their digital making projects 


ACCESS THE CURRICULUM 


A PDF version of the curriculum is available to 


Learning for all 

The Raspberry Pi Curriculum is 
open to everybody, regardless of 
age or experience. “We wanted 
to avoid the age-related and 
stage-related labels that are 
often associated with a learner’s 
progress,” reveals Carrie Anne, 
“Calong with] the preconceptions, 
these labels bring.” 

The Raspberry Pi Foundation’s 
igital making curriculum is not 


download direct from the Raspberry Pi Foundation: 
magpi.cc/2kZzvu0. 


exam specifications in a fun and 
tangible way. 

The Foundation is continuing 
to expand its catalogue of free 
educational resources. It expects the 
curriculum to grow and improve, 


Q 


We want to help people to make things 
so that they can become the inventors, 
creators, and makers of tomorrow 


intended to be a replacement for 
computer science-related curricula 
around the world. 

It hopes that following the 
learning pathways will support 
the study of formal curricular and 


but is requesting input into that 
process. This is “vital” says Carrie 
Anne. So please do take a closer 
look at the program (see ‘Access 

the curriculum’) and send your 
feedback (see ‘How to get involved’). 
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HIGH SCHOOL REPLACES COMPUTERS WITH RASPBERRY PI 


HIGH SCHOOL 


REPLACES 
COMPUTERS 


WITH RASPBERRY PI 


ne school in Cleveland, 

Ohio has chosen to use 

Raspberry Pi rather than 
buy expensive new computers. 

Instead of the Raspberry Pi 
being a limitation, the smaller 
boards have enabled MC2 STEM 
to implement a full computer 
science curriculum. 

“MC2 STEM High School is a 
unique school,” says Feowyn A 
MacKinnon, head of school. 

There are 50,000 students in the 
district, and 100% of them qualify 
for free and reduced meals. As a 
result, the technology situation 
can be quite bleak. 

The computers at MC2 were 
ten years old and hopelessly out of 
date. “More useful as paperweights 
than technology,” Feowyn tells us. 


MELE TALS 


ca | 
yr 


Amobile Fab Lab enables MC2 
STEM students to build projects and 
demonstrate them to nearby schools 


Feowyn, “we have come to depend 
completely on Raspberry Pi.” 

It turns out the Raspberry Pi 
is better for teaching STEM than 
traditional equipment. “Our 


The Raspberry Pi 1s better 
for teaching STEM than 
traditional equipment 


Traditionally, schools in America 
would have a fund-raising drive to 
try to secure the money required 
for new technology. However, MC2 
had a better idea. 

“Rather than try to fund-raise 
for new technology,” explains 
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students experience an innovative 
and fun project while building 
their Raspberry Pi computers,” 
reveals Feowyn. 

MC2z2 is now teaching a full year- 
long computer science curriculum 


using only Raspberry Pi computers. 


~~ 


“T imagine we may be one of the 
only high schools doing this,” 
says Feowyn. 

“The Raspberry Pi then evolved 
from just a cool, fun, learning 
experience to an all-encompassing 
educational tool that our school 
and curriculum truly depend on,” 
he continues. 

MC2z2 is also the first high school 
in the US to own a mobile Fab Lab. 
“The mobile Fab Lab comes in 
handy when we want to express 
our ideas to other schools,” says 
MC2 STEM student Brandon 
(magpi.cc/2kLla6s). “I like the 
idea of project-based learning and 
being able to build stuff with your 
hands, instead of always doing 
writing work.” 
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CREATE 
SOMETHING 


es ee?) VVITH WD PIDRIVE 
SW es, WY COMPUTE CENTRE 


Includes custom NOOBS, Raspbian PIXEL, and Raspbian Kit Includes: 
Lite on a bundled SD card. Organize multiple projects WD PiDrive Foundation Edition 375GB 
in one place with Project Spaces™. Easily assemble Raspberry Pi 3 


: Wireless Keyboard & Mouse 
components in a custom enclosure. nye 
Black Square 6"x6" Enclosure 


WD PiDrive Cable 
5V 3A power supply and USB cable 
microSD card (with preloaded software) 


© WD LABS Learn more at wdlabs.wd.com/magpi55a 


ens OUT 


SES 


Fake Raspberry Pi cases doing the rounds 


FAKE 


nscrupulous dealers are computers, cases, cameras, and 
selling fake Raspberry other products goes straight 
Pi cases on third-party into our charitable fund to train 
websites and eBay. teachers, provide free learning 
\. 4 Kinneir Dufort designed the resources, teach kids, help build the 
official Raspberry Pi case. While foundations of digital making in 
there are many third-party cases schools, and much more.” 
©e@ available, the fake cases are Let The Raspberry Pi Foundation 
I aaa } intended to mimic the official case. know if you find fake cases in the 
—————— The Raspberry Pi Foundation wild. “It damages our reputation 
managed to get its hands ona when something shonky comes on 


It damages our reputation 
when something shonky 
comes on the market 


sample through a proxy pretending the market and it looks like we’ve 
to be a Pi shop. It supplied some made it,” explains Liz. “It damages 
68 £ 9) 2 | pictures so the community can see the Raspberry Pi Foundation’s 
pO y the differences. pockets too, which means we can’t 
Alc “The fake cases are not as well do the important work in education 
made as the real thing,” says Liz we were set up to do.” 
This fake case has two sets of light pipes Upton, director of communications. You can see examples of 
The shoddy feet on this case are a clear sign of a fake “They also deprive us of some fake versus real cases on the 
much-needed charitable income. As _ Raspberry Pi Foundation website 


you probably know, the Raspberry (magpi.cc/2kLw3pf). Please let 
Pi Foundation is a charity. All them know in the comments if you 
Gna the money we make from selling come across any fakes. 
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The stories we shared that 
flew around the world 


he Raspberry Pi Foundation — that will help educators connect, 

has launched a new share great practice, and learn 

magazine called HelloWorld from each other.” 
(magpi.cc/2j4HuJ9). Hello World is available free, 

Hello World is a magazine about forever, for everyone online asa 
computing and digital making. downloadable PDF. The content 
It’s “written by educators, for is written to be internationally 
educators,” says the Foundation. relevant, and includes features on : 

Hello World is designed to be the most exciting developments nea erase 
cross-curricular and useful to all and best practices from around Got a Raspberry Pi that idles away most of its day? 
kinds of educators, fromclassroom _ the world. Lend some of its CPU power to science. 
teachers to librarians. While it A print version of the magazine 
includes lots of great examples of is free to the homes of serving 
how teachers are using Raspberry educators in the UK. The list of 
Pi computers in education, it is eligible subscribers is wider than 
device- and platform-neutral. you think and includes teachers, 

“As with everything we do at teaching assistants, librarians, and 
the Raspberry Pi Foundation, youth workers. Alternatively, you 
Hello World is about community can subscribe for £15 per year. 
building,” says Raspberry Pi Visit the Hello World website to 
Foundation CEO, Philip Colligan. sign up for your free subscription 
“Our goal is to provide a resource (magpi.cc/210KN1R). 


i MAGAZINE 


WeLCOMe TO TH 


magpi.cc/2jyzU4V 


Discover the joy and art of computer 
programming with your Raspberry Pi. 


OR COMPUTING 


Hello World isa 
new magazine from 


the Raspberry Pi magpi.cc/2hNaep3 
Foundation that’s 
free to all educators This Wire and Loop game is a great project for learning 


basic circuits, electronics, and Python coding. 


raspberrypi.org/magpi March 2017 ‘WMeig?i 


BAXTER 
USA, 2015 
Protiaced np Ratinink Rasbotics 


Fest \uoncherds 2012 
Total weld as of 28TH Over 2000 


Baxter 

is the world's 
first two-armed 
robot designed 
to work together 


with people | 


RoboThespian was 
the first full-sized 
humanoid robot to 
be commercially 
produced 


Rob's 

Open Source 
Android was built to 
move like a human 


— —| 
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New exhibition brings 100 robots under one roof 


ver 100 robots are 

on display at anew 

exhibition at the Science 
Museum, London. 

The exhibition is called ‘Robots’ 
and is set to last all summer. 

It “explores humanity’s 500-year 
quest to reimagine ourselves as 
machines,” explains the museum. 

Robots is open daily until 
3 September 2017. Tickets are on 
sale now (magpi.cc/2kLvyeO). 

Ian Blatchford, director of the 
Science Museum Group, says: 
“This stunning exhibition explores 
the fascinating question of why, 
rather than how, we build robots. 
To look through the eyes of those 


who built, commissioned or 

gazed upon these mesmerising 
mechanical creations over the past 
500 years reveals so much about 
humanity’s hopes, fears, dreams, 
and delusions.” 

Pepper is a humanoid companion 
created to communicate with 
humans through voice and touch 
and movement. This robot invites 
visitors to touch its hands and fist- 
bump while sharing a story using 
the screen on its chest. 

Baxter, REEM Service Robot, and 
Amico are industrial robots with 
amazing precision, while robots like 
ROSA, Inhka, and RoboThespien are 
used to interact with humans. 


Some of the robots are incredibly 
lifelike. Zeno R25 has incredible 
expression, while Nao will dance, 
blow kisses, and exercise. 

Diving head-first into the 
uncanny valley is Animatronic 
baby. The baby breathes, sneezes, 
and moves its arms and legs. It’s 
designed to make you feel strong 
emotions towards a robot. 

Ben Russell, the lead curator 
of Robots, says: “Coming face to 
face with a mechanical human 
has always been a disconcerting 
experience. That sense of unease, 
of something you cannot quite put 
your finger on, goes to the heart of 
our long relationship with robots.” 


ry 


Allimages courtesy of the Science Museum 
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GOOGLE TOOLS 


Tech giant asks makers for advice on AI tools G O PiGo 
20+ new projects for your Pi robot car. 


oogle is going to arrive in style in 2017. The tech 
titan has exciting plans for the maker community. 
It intends to make a range of smart tools available 
this year. Google’s range of Al and machine learning 
technology could enable makers to build powerful projects. 

To make this happen, Google needs help from the 
maker community. Raspberry Pi fans are the best 
makers around, and it’s their ideas that will give the tech 
company direction. 

Here’s what Google has to say: “Hi, makers! Thank you BD) ICAP i 
for taking the time to take our survey. We at Google are 
interested in creating smart tools for makers and want LEGO MINDSTORMS + RASPBERRY PI 
to hear from you about what would be most helpful. As a 
thank-you, we will share our findings with the community 
so that you can learn more about makers around 
the world.” 

The company can produce some serious tools for the 
maker community, so make sure you have your say to get 
the tools you need. 

Let Google know what you would like by filling out the 
survey: magpi.cc/21152MR. 
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Build upon Adafruit’s amazing Pi GRRL 2 using the brand new = 
Pi Zero W to create the ultimate retro handheld console... is 
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YOUR PARTS 


Here's what you'll need to make the Pi GRRL Zero W 


e| 
“+ i us 


s 


> magpi.cc/2l6zurq < 


The key to this project is the Pi Zero W. The wireless- 
enabled version of the Pi Zero is as powerful as the 

Pi Zero, yet saves a load of space thanks to the radio 
chip included in it, so no WiFi dongle is needed. It 
runs at 1GHz, which makes it powerful enough to run 
emulators of many eighties and nineties consoles. 


eet PELL i bias 


ww ee 
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3D-printed 
case 


a 


> magpi.cc/2lob5Ky < 


WwW 


This is actually a touchscreen, although 

we wont be making use of it in that way. 

The PiGRRL 2 case repurposed for our needs. It fits neatly in the case and provides , ' 
It has some spaces for USB and Ethernet on four extra buttons to use when playing 

a B+/2/3 board, but the Pi Zero will require games. You can also assign system and UI 

extensions if you want to make use of the gaps. shortcuts to the buttons. 


Soldering iron 
Wire 

Heat shrink 
Glue 


“i 


Blu-Tack 
Wire strippers 
Hobby knife 
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BUILD A HANDHELD GAMES CONSOLE 


a Ss 


iw 


* 


\ % 
\ ALN 


> magpi.cc/2lo5aFg < 


> magpi.cc/2lojfTb < 


This is one of the cool bits: we’re going 
to use this PowerBoost to actually 


This switch allows you to turn the power 
on and off. It’s best to do the software 


charge a battery within the handheld. shutdown of RetroPie first before " 
With the low power draw of the Pi and switching the power off, though. | i 
advancements in modern battery tech, ' | 


you'll get a lot out of one charge. 


Microswitches 


> magpi.cc/2lo8g0i < 


WPA Abii 


The beauty of proper retro gaming is tactile 
controls. You’ll need ten 6mm switches, 
and a couple of 12mm buttons. 


| 


IN 


il 


> magpi.cc/2lohN2U < 


With 


A wonderful innovation from Pimoroni, 
these GPIO headers require zero 
soldering and can be (carefully) 
hammered onto the empty 
pins of a Pi Zero. 


We squeezed the biggest battery into 
here that we possibly could. This way, 
it should last for hours and hours. 


A selection of 
screws to attach 

1 =3 the parts to the 
case. This includes 
14 #4-40 and 
6x #2-56 3/8 
machine screws. 
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THE BIG BUILD 


—— 
PRINT THE 


What you need to know about 3D-printing the Pi GRRL 2 case 


ny PIGRRL 2 - Raspberry Pi Game Console 
+ 
——— 5 


HOW TO PRINT 


YOUR 3D CASE 


pigrrl2-top.stl 


pigrrl2-bot.stl 
pitft-buttons.stl 
dpadz2.stl 

action-btns.stl 
pause-start.stl 


shoulder-btns.stl rs Las ia Cs FA a, 


shoulder-mount.stl 


>STEP-@2 : 
FIND A 3D Where 3D prints are made 


PR IN T = R Find the right 3D printing service for your ne> 


It can be tricky to find a good 3D printing service 
online, so unless you have access to a 3D printer, we 


| Bronse 20 ping serene — 


highly recommend using 3DHubs.com. It lists local 3D 
printing services, along with an estimated completion parts printed ig 2 orton oi 
time and reviews. The files we downloaded also work 

with the service. oe 


658,611 


er 


tup Costs 


ihoulder-btns.stl 


rigrrl2-bot.stl 
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BUILD A HANDHELD GAMES CONSOLE 


YOUR P! 


Get your Pi Zero W ready to be made into a retro gaming treasure 


The configuration screen starts by asking 
about your current controller setup 


WELCOME 


(= LEFT SHOULDER ] = RIGHT SHOULDER ] 

Pee = =] 

eo 70) D-PAD UP 
(<g> D-PaD LEFT D-PAD LEFT ) 
( eG D-PAD DOWN D-PAD DOWN } 5 

eb D-PAD RIGHT D-PAD RIGHT 

- SELECT ) ( qm START } $ cd 
. . . $ curl -O https://raw.githubusercontent. 
When you come back to reconfigure your buttons, refer to this handy guide 


com/adafruit/Raspberry-Pi-Installer- 
Scripts/master/pitft-fbcp.sh 


SETTING LP WIRELESS $ sudo bash pitft-fbcp.sh 


Wireless connectivity on the new Pi Zero W is great, but the 
configuration method for wireless LAN on the RetroPie is very 
basic. You’ll need to know the name of your wireless network 
(SSID) along with the password, as it won’t be able to search for 
available networks. You can also import details by loading a .txt 
file onto the boot partition. 


$ cd 
Configure WiFi $ curl -O https://raw.githubusercontent. 
Wiese 0: =e Oe com/adafruit/Raspberry-Pi-Installer- 
ae Scripts/master/retrogame.sh 
3 Tepe vifi Scoot none MFT COIS eutitestat $ sudo bash retrogame.sh 
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THE BIG BUILD 


BUILD THE 


Follow along and build your retro handheld 


ADD THE 
BUTTONS 
Now it’s time to carefully solder 
the ten 6mm microswitches 

to the front of the board. 

Some helping hands would 

be good here. 


peege yr 
i A - pf : 


L. - 


>STEP-@3 


TURN ON 
THE BACKLIGHT 


By default, the PiTFT doesn’t have its backlight 
turned on. You need to take a craft knife and cut the 
circuit between the blocks in the #18 box that you 
can see circled in the picture. 
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BUILD A HANDHELD GAMES CONSOLE 


It’s a good idea to shorten 

the ribbon cable. 108mm is 
apparently the perfect size, but 
you can go a little longer. Once 
you’ve measured it, cut the cable. 


>STEP-06 


PREPARE 
FOR POWER 


To make all our soldering easier, we’ll dab some 
solder onto the spots where we need it for the 
moment. On the PowerBoost 1000C, add some 
solder to the positive and negative pins, and the 
EN and GND pins. Cut one of the legs off the power 
switch and put some solder on the other two. 
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ON/OFF ZERO /ABS 


>STEP-@5 


Using something like a pen or pin, you’1ll need to push 
in the clip that holds the connector in place on the 
part you’re discarding. Very carefully remove the cable 
and install it at the end of your newly trimmed cable. 


G PuR | 
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THE BIG BUILD 
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>STEP-O1 


Make sure the power switch will fit in the hole for it in the case — it’s on 
the side of the bottom part. You may need to file away the plastic a bit. 
Once that’s done, trim two short bits of wire to about 7cm long and solder 
one to each leg. Solder those to EN and GND - it doesn’t matter which way 
around they go. 


SHOULDER 
BUTTONS 


The shoulder buttons (the 12mm ones) need to 
be attached to the controller board much like the 

SP Oh GOREA Tape switch was connected to the power board. Clip two 

‘ legs off each and use a pair of pliers to flatten the 

remaining two. Solder wires to each pin (about 14cm 
long) and then solder the other end to the bumper 
pins on the controller board. Again, polarity doesn’t 
matter, but keep each one as a pair in the row. 


Wasatruit 


©--QPIGRRL 


>STEP-@9 


WIRE IT 
ALL UP 


Now we can combine the power 
with the controller board, which 
will allow us to provide power 

to the whole system. Solder two 
wires (about 14cm long) to the 
underside of the 5V and GND pins 
on the controller board. The 5V 
wire should then be soldered to the 
positive of the PowerBoost board, 
with the GND to the negative. 


|e 107 
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HAMMER 
THE HEADS 


It’s now a good idea to add the GPIO 
headers to the Pi Zero W. Gently 
hammer them in until they’re secure, 
and you’re done. 


TEST IT ALL OUT! 


>STEP-12 


You’ll now need to mount the back buttons and 
the PowerBoost. The rear buttons have a plate 
that keeps them in place, and Adafruit suggests 
using a little Blu-Tack to stick the switches in 
position. You’ll attach the power switch and then 
finally screw on the PowerBoost. Be careful with 
the wires that you’ve soldered on. 


— t 1080Q a4 
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>STEP-13 


CLOSE IT UP 


Now you can finally close it up! Insert 
the battery and tape it down if need 
be, before screwing it shut. Make sure 
all the cables are safely inside the case 
before tightening it, though! 
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THE BIG BUILD 


Here's some of the amazing advantages 


of having the PiGRRL powered by Pi Zero W 


ssh pi@retropie 


Category: 

Session | __ Basic options for your PUTTY session 

* beagng | Specty the destination you want to connect to 
Ke Host Name (or IP address) Poa 
Bat Neto 2 
Features Connection type: 

Wedeer Raw © Tere © Rogn @SSH © Senal 
® Load, save or Gelete 2 stored session 
Translation Saved Sessions 
Salecton 
o nn 

© Coreretion barca | Couesa) 
Ona 
Pe = 
Telnet | (Oeste) 
Riogin, | 
= Cee window on ext: 
Aways Never @ Only on clean ext 
| 
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Version: 4.0 ee ia 
Last Commit: 26 minutes ago (@caded9) 


pasic install 

Update all installed packages 
Manage 

Configuration / tools 

Update RetroPie-Setup script 
Uninstall RetroPie 

Perform reboot 


RPxKxYUO VC 


< Exit > < Help > 


UPDATING 
RETROPIE 


You can update RetroPie from the handheld itself 
or via SSH in the command line. The keyboard 
might be better suited for this, so if you’re by your 
computer it wouldn’t hurt to use it instead. 


From the handheld, you need to go to the 
RetroPie menu in EmulationStation and activate 
the setup script. From the terminal (if you’ve 
SSHed in), you can use the following command: 


sudo ~/RetroPie-Setup/retropie_setup.sh 


From here, look for the ‘Update All Installed 
Packages’ option. There are many options here 
that you can select from, including managing the 
individual packages in case you want to remove 
or add any. To update, you can select the option 
‘Update all installed packages’ (which will also 


update the RetroPie-Setup script as well) or 

you can go to ‘Manage packages’ and update the 
packages individually. This could be useful if any 
packages have some problems updating, or if you 
want to do the essential updates before running 
out the house. 
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@ New Site 
 root@192. 168.0.110 


C= Lo" 
i i Bre £ 
Organize ¥ Network and Sharing Center _—_-View remote printers z+ Fl @ 
B Videos a 
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Share 
2@ Homegroup —< 
configs 
1 Computer JP) Share 
& Local Disk (C:) a 
roms Select a file to preview 
Sil Network > ee 
M 192.168.0.107 = 
1! CAPTAIN_BLINKY 
7M RETROPIE 
3 items 
A i 
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O an do so e Pp ero ale 
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System: snes 

Emulator: lr-snes9x-next 
Video Mode: 

ROM: Mask, The (U) 


select default emulator for snes (1r-snes9x-next) 
2 Select emulator for rom () 

4 Select default video mode for Ir-snes9x-next () 

5 Select video mode for Ir-snes9x-next + rom () 

§ Select RetroArch render res for Ir-snes9x-next (64¢ 
3 Edit custom RetroArch config for this rom 

® Launch 

Q Exit (without launching) 

2 Launch with netplay enabled 
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CAUTION! 


PIRATING VIDEOGAMES IS BAD, 
NOT TO MENTION ILLEGAL! 


Don't use illegally downloaded 
content on your PiGRRL. 


Session 


Eile protocol: 


| SFTP 


Host name: 


Port number: 


RETROPIE 
User name: 
pi 


Save 


24 


Password: 


| Advanced... ly] 


| Help 
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THE 
RUIZ BROTHERS 


We talk to the original creators behind the PiGRRL and many other amazing Adafruit projects 


wo of the superstars of the maker scene are Noé Ruiz 

and Pedro Ruiz, otherwise known as the Ruiz Brothers. 

They’ve done many amazing projects for Adafruit, 
including a lot of 3D printing and wearables, which always go 
down well with the community. So it’s surprising to hear they’ve 
only been in the maker scene for about five years. 

“My brother and I purchased our first 3D printer in 2012 and 
quickly started using it in our work,” Noé tells us. “While looking 
for a way to integrate lighting into our 3D-printed designs, we 
discovered Adafruit and the Arduino platform. We built some 
projects using their parts and came up with some unique ideas. 
We went on Adafruit’s weekly live show-and-tell show, and the 
rest is history.” 

What started off as a load of cool hacks that added LEDs to 
existing products or enabled you to create great light-up projects 
quickly evolved into doing more. Part of this was to do with the 


introduction of the Raspberry Pi. 
“Our first project with the Raspberry Pi was the DIY Wearable Pi 
with Near-Eye Video Glasses,” explains Noé. “We were interested 


26 | MagPi March 2017 raspberrypi.org/magpi 


BUILD AN AWESOME RETRO HANDHELD 


FROM THE 
RUIZ BROTHERS 


Other amazing things you can find 
by Noé and Pedro 


in Google Glass and thought we’d make a DIY version with the 
Raspberry Pi. We hacked apart a pair of video glasses, and designed 
a custom 3D-printed housing for the display and driver. It was a fun 
experiment and this is how we learned about the Raspberry Pi.” 

Things escalated even further when the brothers made the 
original PiGRRL. Originally an idea from Limor Fried, founder of 
Adafruit and ‘Ladyada’ herself, the idea was to improve upon her 
earlier Game Grrl project but this time use a custom 3D-printed 
enclosure. It was their biggest project to date, so they were 
extremely happy to see that it had such a positive reaction. 

The PiGRRL projects have since become the Brothers’ favourites 
to work on, according to Noé. 

“T think it’s become a classic Raspberry Pi project because it 
looks like an iconic device that offers lots of playtime. People love 
to play games, and being able to build your own gaming console is 
super-rewarding. Every year we create a new version with better 
hardware, and change the form factor to try different designs. So 
many folks have built one and it’s really awesome to see parents 
building them with their kids.” 

What’s in the future for the PiGRRL and the Ruiz Brothers? Well, 
PiGRRL 3 is happening this year with a “bigger screen and better 
audio”, and should be a much quicker build. Watch this space! 
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a 
_ SUBSCRIBE TODAY AND RECEIVE A 


Subscribe in print for 12 
months today and receive: 


A free Pi Zero W (the latest model) 
Free Pi Zero W case with 3 covers 


Free Camera Module connector 
Free USB and HDMI converter cables 
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» The display 
resolution is 
128x64 


» Currently, it 
costs around 
$50 in parts 


» It connects to 
a 2G network 
(a 3G model 
is planned) 


» The OS is 
based on 
Raspbian Linux 


» There are plans 
to crowdfund 
the project 
as a kit 


A SIM800 GPS module 
and antenna are used to 
connect to the mobile 
phone network 


Asmall LCD screen 


displays the operating 
system (based on 
Raspbian Linux) 


Buttons are connected 
to the PCB, and an 
ATMega328P module 
is used to convert 
button pushes into 
phone commands 
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PHONE 


Turning a Pi Zero 
into a mobile phone 


eroPhone is an open- 

source project to create 

a mobile phone kit for 
the Pi Zero. 

Owners of ZeroPhone will be 
able to make calls and send text 
messages. It will also have basic 
apps such as an alarm clock, 
calendar, calculator, web browser, 
and music player. 

Behind the project is Arsenijs 
Picugins, an 18-year-old student 
from Riga, Latvia. He now has a 
team of people helping him. 

“It?s open-source, Linux- 
powered, and you can make one 
yourself for $50,” he says. 

Arsenijs has been studying 
mobile phones for a couple 
of years. He hopes to sella 
commercial kit, while keeping 
it all open-source for people to 
build themselves. 

“The phone hardware is at 
‘alpha’ stage,” he tells us. 
Arsenijs has designed the 
first revision of PCBs (printed 
circuit boards) and is developing 
the software. 

“The next revision will be 
ready-to-assemble,” reveals 
Arsenijs. Raspbian is being 
customised to run on the 
ZeroPhone. “It can be tailored 
to suit our purpose very easily,” 
explains Arsenijs. 

“Pve currently got a framework 
I’m using for headless Pi 
configuration,” he continues. 
Python is being used to create 
a user interface (UI). An 


raspberrypi.org/magpi 


py 


I 


Above The components and software are under development, 
and a kit will be made available when it’s ready 


earlier project called pyLCI 
(magpi.cc/2kjv20A) forms the 
base of the interface. 

Developed by Arsenijs in 
2016, pyLCl is a Linux control 
interface. It enables you to 
control and configure your Pi with 
SSH, networking, or using an 
HDMI monitor. 

“T developed it because that’s 
what I needed to improve 
my Raspberry Pi tinkering 
and development workflow,” 
recalls Arsenijs. 

“Developing a good UI is one of 
the primary goals of this project,” 
Arsenijs adds. 
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“That’s what I’m focused on, and 
that means extensively testing 
the hardware I’ve got now, to find 
everything that has to be fixed.” 
Once v1.0 is ready, he will 
publish the design files and 


instructions, so people will be 
able to start assembling their 
phones if they wish. He’ll then 
prepare a crowdfunding campaign 
to fund a manufacturing run and 
software development. 

“Tt’s the only phone you can 
assemble by getting all the parts 
yourself,” claims Arsenijs. It 
doesn’t use any rare parts or fine- 
pitch soldering. “You can even 


I developed it because that's 
what I needed to improve my 
Raspberry Pi tinkering 


Because Linux is the base, it can 
support a range of programming 
languages. Arsenijs expects 
“original ideas” for apps. He will 
be working on productivity and 
healthcare apps. 

The open-source software 
approach is “likely to be secure 
and not privacy-invading,” says 
Arsenijs. You can disable features 
you don’t like, and it doesn’t 
depend on any cloud services. You 
will be able to install firewall, I2P, 
and TOR nodes, as well as secure 
messenger services. 

Arsenijs’s current goal is to 
make the v1.0 PCB revision. 
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breadboard this 
dedicated enoug 


phone if you’re 
ine 


“For me, this project isa 
huge undertaking that, if done 


right, will influe 
perceive mobile 
Arsenijs. He exp 


nce the way we 
phones,” remarks 
ains that it will 


help solve privacy and security 


concerns, as wel 
develop better o 


technology. It wi 


las allow us to 
pen-source GSM 
ll also help power 


mobile phone hacks. 


“Besides, this 


isan open-source 


Linux-powered phone you can 
independently assemble for less 
than $50,” observes Arsenijs. 
“That’s pretty cool.” 


>STEP-03 
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TRACKING 
MOUNT 


For Mike Hamende, making something is far more exciting and rewarding than 


logging into an online store, as his Pi- powered tracking telescope mount proves 
a - ee 


f you search for Mike i a 
Hamende’s user name Mike 3D-printed several ||_ 
‘gPumpkinDonuts’ online, parts of the mount 
; ‘i . : =| when he was unable to ; 
you’ ll soon realise that he’s quite > find the correct pieces \ 
the craftsman. From a suspended 
‘ ounger for his fiancée, toa 
no previous i . 
experience of wristwatch built completely from 
coding Python scratch, Mike is a true maker. So 
> The tracking it’s really no surprise that he’d 
mount is set to eventually build a Raspberry Pi 
is es preset project that we could sink our teeth 
cations A 5 a : 
nto. Despite his lack of previous 
Python knowledge, and ignoring 


» Mike has 


» The mount runs 


ona battery, : 
making it the fact he could easily purchase 
portable what he’d decided to build, Mike 
» Itcost produced a tracking telescope 
$350-$400 mount for his 8” Orion reflector. 
bulls “This is definitely the most 
» See a video involved project I’ve ever 
Gotiaites: completed,” Mike tells us. “I’m 
magpi.cc/ aware there are mounts | could 
2IGLgWF have bought to accomplish the 
same thing, but, while astronomy 
is a hobby of mine, building things 


is what I’m really into.” 

Mike used two Nema 17 stepper 
motors, powered by a Raspberry 
Pi 3, to angle the mount. For 

the frame, he used 3x3” T-slot 


f The Raspberry A The mount runs ona 
aluminium, utilising his CNC - Pi sits beneath a ; 12V/12AH SLA battery 
. : touchscreen, housed ‘ hooked to the back of 
mill, CNC router, and CNC lathe ina 3D-printed case \ LP therame 
to cut further pieces of aluminium 3 es “ 
for the mount. - ic JL hy “ia LLG. 
Sy 
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The red tint to the screen 
helps to better protect 
Mike's night vision when 
realigning to new objects 


Two turntables with 60mm 
thrust ball bearings act as the basis 
for the motion mechanics, cut 
from 1/2” thick aluminium. Mike 
then had to build his own drive 
pulleys using 3D-printed parts and 
fibreglass flanges. He amended 
technical documents he’d found 
online, removing teeth, until the 
pulley fitted perfectly within the 
build. From here, he also went on 
to print, rout, and fit all the pieces 
needed for the mount and frame 


to control the stepper motors and 
linear acceleration, so he was still 
faced with the challenge of quickly 
learning enough Python to see 
him through. 

Once he’d cleared up his 
prototype breadboard and 
soldered the boards into 
place, Mike fitted the Pi witha 
touchscreen. The screen enables 
him to select one of 800 preset 
targets for the telescope to focus 
on. If he wants to view any other 


My hobby is making things and 
I've been doing it since I was old 
enough to hold a screwdriver 


before turning to a less—-familiar 
subject: the Raspberry Pi. 

Mike originally created a script 
that would position the telescope 
to align with celestial objects by 
way of information from the US 
Naval Observatory. However, 
upon completing the code, he 
discovered PyEphem, a Python 
package that offered a much larger 
scope for celestial exploration. 
Though he had the PyEphem 
code, he couldn’t find anything 
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object, he simply uses a smal 
wireless keyboard to enter the 
chosen coordinates manually. 

Mike went to school to study 
mechanical engineering, though 
he attributes much of his skill 
to being a hobbyist. “My hobby 
is making things and I’ve been 
doing it since I was old enough 
to hold a screwdriver.” He even 
converted his home lathe and 
router to be CNC, and built his 
own 3D printer too. 
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Asimple case: you can 3D-print 
one or get a pre-existing case 
that supports a 3.5” screen 


heartbeat monitor 


It's a very neat setup: a Pi, 
a screen, and a Bluetooth 


Data is live-plotted but can 
be reset at any time, with 
the old data saved to file 


It took two days 
for Daniel to 
develop the 
software 


Daniel wants to 
make an open- 
source voice 
assistant 


If you use the 
project, make 
sure the code 
launches 

at boot 


Danielis an 

old hand with 
the Raspberry 
Pi, using it 

to automate 
several projects 


The case is to 
protect the Pi 
from sweat and 
spilt water 


DANIEL FERNANDEZ 


A chemist, blogger, and consultant 
with a life-long passion for 
electronics and DIY projects. 
github.com/danielfppps 


MONITOR 


The Raspberry Pi is increasingly being used in health applications - 
here’s how one maker made his own DIY Pi health device 


he current surge of smart 
T watches, however long 

it lasts, probably owes 
something to the activity trackers 
that are synonymous with anyone 
trying to keep track of their fitness. 
These devices track the user’s 
heartbeat and use it to calculate 
things like periods of rest, calories 
burnt, and more. You can tella 
lot of things from a heartbeat, so 
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Daniel Fernandez has decided to 
create his own heartbeat monitor 
with help from a Raspberry Pi. 

“T have always liked to monitor 
my heartbeat while I run on the 
treadmill,” Daniel tells us. “There 
is simply no cheap, commercial 
solution that did everything I 
wanted: to plot the results in a graph 
that’s easy to monitor, so that you 
can look at them while you run, and 


then save the data so that you can 
work with it later. Furthermore, | 
wanted some flexibility in how the 
data was plotted and how often the 
heartbeat was updated, and to be 
able to retrieve the data from the 
device in an easy-to-process format 
like CSV.” 

So began Daniel’s build. He 
selected the Raspberry Pi 3 as it 
was a fully fledged computer with 
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You only need four items to make the monitor - how many projects are this simple? 


built-in Bluetooth that could fit “So far, the Raspberry Pi has 

on his treadmill. He coupled it always worked correctly with my 

with a Polar H7 heart sensoranda _ heartbeat sensor,” Daniel says. 

3.5 screen, and 3D-printeda little “The program has always provided 

case to fit it all in. smooth plots and a very responsive 
“Tt’s not very difficult to build display of my real-time heartbeat. 

as most of the project is based I have been able to save my run 

on software,” explains Daniel. data files and perform some more 

“Tf you have the sensor, screen, extensive mathematical analysis 

and software, you could have it to better understand how my heart 


If you have the sensor, screen, 
and software, you could have it 
working in less than a few hours 


working in less than a few hours. reacts to changes in intensity, 
I have made the software open cadence, inclination, and so on. 
source and available via a GitHub “T would want to include some 
repository [magpi.cc/2kBjoaM].” functionality to save my heartbeat 5S -F-o 
He’s been successfully using it files to my Dropbox and even have ri 
for its intended purpose, havingrun _ the option to share the data on 7 
20 miles with it since he finished my social media accounts when | 
the project. finish each run. I was also thinking 
about connecting the treadmill’s | 
control panel to the Raspberry Pi | 
so that the treadmill could adjust 
intensity automatically to match 
a target heartbeat.” 
Other heartbeat sensors that — 


follow the same standard as the 
Polar H7 should work with the 
= project if you decide to make 
your own. Maybe it’s a good 
excuse to keep up with your New 


The Pi waits patiently until it ‘ 
gets data from the heartbeat monitor Year’s resolution? 
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£12.99 


200 pages of 


THE Official Raspberry Pi 
RASPBERRY PI 


PROJECTS BOOK 


VOLUME 2 


Amazing hacking and making projects 
from the creators of MagPi magazine 
Inside: 

How to get started with Raspberry Pi 
The most inspirational community projects 
Essential tutorials, guides, and ideas 


Expert reviews and buying advice 


Available 
ne magpi.cc/MagPiStore 


plus all good newsagents and: 
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Build your home theatre media centre with a Raspberry Pi and OSMC 


uilding a media centre, or HTPC (home 
theatre PC) is one of the most rewarding 
projects a newcomer can complete. 
It’s easy to turn a Raspberry Pi into an HTPC, and 
you can quickly hook it up to your television 
Using an HTPC, you can play video and music files, 
and stream video and audio from online services. And 
unlike proprietary systems, such as Apple TV and 
Google Chromecast, you can use it to play just about 
any media format. 


You can add streaming services to your HTPC, such 
as BBC iPlayer and Soma radio stations. These enable 
you to play media directly from the internet 

There are several pieces of software available for 
setting up an HTPC. Two options you’!I find on the 
2aspberry Pi Foundation’s Downloads page are OSMC 


D etcher 


© Nees Help? O 


and LibreELEC. Both are similar and run a media r] _| @ 
7 * SELECT mace SELECT ORIVE FLASH MAGE 
player called Kodi. S a 5 
In this guide, we’re going to opt for OSMC. It’s a 
ie a . 7 7 OSMC_TGT_...24,lng-g2 @ féevisdb -7.9GB pa 
free and open-source media centre built on top of 


Debian, and is reliable and easy to use. 


- 


Setting up OSMC on a Raspberry Pi is METCHER 


a straightforward and rewarding project 


Let’s get started. 


t) Videos 


Return of the Kung Fu Dragon 


COWNLOAD OF TIONS. 


Return_of_the 


Kung_Fu 


q ISS Live Stream 
Educational Channel HD 
Media Channel HD 
iss HD Earth Viewing - ustream 
ISS HD Earth Viewing - urthecast HD 


Queue after current 


Queue 


Play 


Cancel 


Back up the files on a Raspberry Pi so you can quickly restore your files 


Raspberry Pi 


SD card 


Flash drive J 


{ Adding a password to your backup can secure the Déja Dup is a popular program Files backed up using Déja Dup are 
\ files stored remotely (or on an external drive) used to schedule backups restored using the same program 
ae | 


Te - 


i '? = 
Require Password? 7 iinet backep was todah 
f9 You can restore the entire backup with the Restore... button or use Files to either 


© Allow restoring without a password revert individual files 0/ restore missing ones. 


© Password-protect your backup 
You will need your password to restore your files. 
You might want to write it down. 


No backup scheduled. 
You should enable automatic backups or use the Back Up Now.. button to start one now. 


Back Up Now. 


Encryption password | sr » 
cotpssvd| =| | 

© Show password 

(2 Remember password 
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S$ Win32 Disk imager 


>= You can clone you 
dd ona Mac or Linux, and Win32 D 
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‘No recent backups. 
‘You may use the Restore... b.tton to browse for eosting backes. 


No backup scheduled. 
‘You shod snuilie automatic backups oF ube the Back Up Now_ bution 10 start one now 


{ Back pron. 


Above? 5(- 
can be restored 
individually, or 


The speaker will 


do the talking 
for Alexa 


The USB microphone 
will do the listening 
for Alexa 


The GoPiGo will 
do the walking 
for Alexa 


HOW TO MAKE AN 
me ALEXA-POWERED 


2hA8f6i 
Raspbian for 
Robots 
magpi.cc/ 
2kixPxB 
Speaker for the 
Raspberry Pi 
magpi.cc/ 
2hAgCi7 


Microphone 
amzn.to/ 


agommaV Build an Amazon Alexa-controlled robot using the Raspberry Pi, 
Mine allowing you to operate it with just your voice 


Developer 
account 


inally, a Raspberry Pi robot to do your 
bidding, controlled only by the sound of 
your voice! Amazon Alexa software can be 
put on the Raspberry Pi robot, the GoPiGo. In this 
project, we’ll create an Alexa-based robot that will 
respond to voice commands, as well as answer your 
questions. You can ask Alexabot “How hot is it in 
Dubai” or “What’s the weather like in Londone”. 
What makes Alexabot really interesting is that you 
can order it around with your voice, using the Alexa 
Voice Service (AVS). 

The first step towards robot world domination 
and building our Amazon Alexa-controlled robot 
is to set up AlexaPi. 


A free IFTTT 
account 
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Tutorial 
filexabot.py 


from flask import Flask 
import gopigo 
import time 


M Make a web request 


This action will make a web request to a 
publicly accessible URL. NOTE: Requests 


DOWNLOAD: 
magpi.cc/2kiFlZz 


may be rate limited. app = Flask(__name_) 
app. route 
return 
http://580b2886.us.ngrok.io/forw 
ard @app. route ( ) 
def (): 
: print ( ) 
Surround any text with "<<<" + Ingredient gopigo.fwd() # Send the GoPiGo Forward 
and ">>>" to escape the content time.s 1) # for 1 second 
gopigo.stop() # then stop the GoPiGo 
return 
Method 
@app. route( ) 
def (): 
GET see 
gopigo.bwd() # Send the GoPiGo Backward 
The method of the request e.g. GET, POST, time.s 1) # for 1 second 


DELETE gopigo.stop() # then stop the GoPiGo. 
return 
Content Type (optional) @app.rou ) 
def 
i print( 
time.s 
Optional gopigo.stop 
return 
- @app.route ) 
Body (optional) ee 
print( 
forward gopigo. right 
time. sle 
Surround any text with "<<<" + Inaredient gopigo.stop 
and ">>>" to escape the content S return 
@app.route( ) 
def (): 
Fig 1 An example of how to build your own command print( 
for each in rz 
There are a few tutorials on how to turn your g0p1g0 2 
Raspberry Pi into an Amazon Echo using Amazon ae k E 
Alexa. However, AlexaPi (magpi.cc/2kiyOx0) is the ee : 
easiest way to get Amazon Alexa on your Raspberry gopigo.bwd() 
Pi. The project has prepared everything to set up time.sleep(@.25) 
Alexa Voice Services on your Pi in a streamlined gopigo.stop() 
and simple manner. The hardest part is setting up return 
your Amazon Developer account and gathering your 
credentials (and really, that’s not that hard). @app PC ) 
At this point, with your speaker and your det : 
microphone plugged into your Pi, you should be able print( ) 
to run Alexa on your GoPiGo, just as you would on perunn 
an acs ae — it for a news update: “Alexa, if name == : 
ae eine mee app.run(debug=True, host= ) 
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Tutorial 


@i 


ngrok by 


Fig 2 Your ngrok 
readout should 
look a bit like this 


TRIGGER 
WORDS 


RUNNING 
THE FLASK 
SERVER 
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nconshreveable 


Next, we’ll set up IFTTT. If This Then That (IFTTT) 
is a service that lets us connect different parts of 
the web together. In our case, IFTTT helps us couple 
Alexa together with the Raspberry Pi. IFTTT lets us 
bridge the AlexaPi responses back to the Raspberry 
Pi. First, you'll need to set up an IFTTT account. 
(ifttt.com/join). Again, this is free. 

Next, you’ll need to add the IFTTT service to your 
AlexaPi. You can do this by first installing the Alexa 
app on your phone or tablet (magpi.cc/2kyIJho); it’s 
available for iOS, Android, and Fire OS. With your 
phone on the same network as your Pi, connect to 
your AlexaPi and add the IFTTT service. 

Next, in IFTTT, we will need an applet for each 
command we want to send to the GoPiGo. First, 
connect Amazon Alexa to your IFTTT account 
(magpi.cc/2kizD9X). Then we’ll do the following to 
create an applet that will handle a single command: 


Create an IFTTT applet (magpi.ce/2jTYYn2) 
for our first command. We will create 
an Alexa applet. 


Specify the command. Say “Backward”. 


We'll use the action service, Maker. 


The URL is either your provided ngrok URL or 
your custom domain. We will find this in our 
next step, but for now we can enter ngrok.io. 


Click ‘Create Action’ and then ‘Finish’. 


Fig 1 shows how this is done in more detail. We 
will need to do this for all the moves you want 
your Amazon Alexa-controlled robot to make! In 
our project, we made seven: one each for Forward, 
Backward, Left, Stop, Right, Dance, and Coffee. 

Next, we’ll connect to the ngrok service. We will 
have IFTTT contact a server on the Pi, but the tricky 
part will be setting up a server on the Pi that’s visible 
to the world outside our local wireless network. For 
this, you can use ngrok (ngrok.com), a service that 
allows you to connect to your Raspberry Pi through 


A robot that will 
respond to voice 
commands 


any network. IFTTT needs an internet-based URL 
to contact, so we’! use ngrok to make our server 
accessible to the outside world. 

First, set up an account with ngrok. You can get 
away with a free account, but it will be much easier to 
set up Alexabot with a paid account. A paid account 
will allow you to set up named servers, rather than 
ngrok’s randomly assigned server. 

Next, install ngrok on your Raspberry Pi using the 
directions here: ngrok.com/download. 

This should install all the software. You will next 
need to get your token, which will authorise your 
Raspberry Pi to ngrok. If you log into your account you 
will see step 2, with your token already populated. It 
should start with ./ngrok authtoken. Copy the 
command, and paste it into your command line. 


Test out ngrok 
You can type the followi 


ng into the command line: 
-/ngrok http 80 
You should then see a server start up, as shown in 


Fig 2. When an IP address appears, try typing that IP 
address into your browser. You should see your default 
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server on Port 80 come up. We will start our server 
with the following command: 


./ngrok http -subdomain=dexterindustries 5000 


... where ‘dexterindustries’ is a reserved domain set 
up with our basic account on ngrok. If you go with the 
free account, you’ ll now need to go back and re-enter 
the domain name that ngrok gave your Pi into each of 
your IFTTT commands. 


Set up the Flask server 
The final step in getting our Amazon Alexa-controlled 
robot working is setting up the Flask server on 
the Raspberry Pi. 

We’ll set up a Flask server in Python to listen to 
IFTTT. To install Flask on the Raspberry Pi, enter the 
following into your command line: 


sudo pip install flask 


You can try running the Flask server we’ve 
provided in our GitHub code and see what happens: 


python alexabot-flask-app.py 


You should see the Flask server start! 

To get an idea of how the code works on the Flask 
server, you can type the following in your web browser: 
http://alexabot.ngrok.io/forward. You should get this 
response in your browser: ‘Alexabot moved forward!’. 

This illustrates how the Forward command works, 
each command will work this way, with its own 
directory and custom code for moving the GoPiGo. 

Now, with all the services set up, we should be able 
to say a command like “Alexa trigger forward”; Alexa 
will alert IFTIT, which will send an HTTP message 
through ngrok back to our GoPiGo and post to the 
web server running in Flask. The Flask program will 
command the GoPiGo to move forward. 

The quick-start method to get running with 
Alexabot is to first start AlexaPi: 


sudo python /opt/AlexaPi/src/main.py 
Next, start ngrok in a separate window: 

sudo ~/ngrok/ngrok http 
-subdomain=dexterindustries -log=stdout 
5000 > log.txt & 

Finally, start the Flask server: 

sudo python alexabot-flask-app. py 

Start talking! Remember, your commands need to 


start with “Alexa trigger...” and then the command 
you want the robot to carry out. 
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GoPiGo 


( ) amazon alexa 


AlexaPi 


Frit 


ifthisthenthat 


ngrok 


Flask 


web development, 
one drop at a time 


Alexabot to respond 
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The flow of information 
for getting the 


to 


your command 
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DS CE Mbicstenp= 


void main (void 
if 

char input(2s6], 
iatage; 
printf ("whet is y ane 
fgets (input, 26, stdin): 
sscenf (input, “wi, name); 


printf 
while (1) 


printf 


‘Winpurc- /nome pi-G 


mane [256] ; 


Hors (input, 256, stdin) 
if (sscanf (input. i") 
printf het was 


Sage) == 


onpthang I recog as a 


SCANF 


Just like sscanf, 
scanf returns 
an integer 
indicating how 
many values 

it successfully 
read, which 


you can use 
to check for 
errors. One 
problem is 
that scanf 


only removes 
matched 
values from the 
input buffer, 
so if a scanf 
fails to match 
anything, 
what the user 
typed will be 
read again on 
the next call 
to scanf. It 
really is easier 
to use fgets 
and sscanf! 


GET THE 
NUMBER 
RIGHT 


Remember 
that the first 
item in the argv 
array - argvlo] 
- is the name 
of the program 
itself, not the 
first parameter. 
The actual 
parameters 
start at argvl1). 
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fgets is the library 
function to read text 
from an input stream 


stdin is the input 
stream associated 
with the terminal 


AN INTRODUCTION TO C 


USER INPUT 


Reading and interpreting input from the user 


n the previous instalments, we’ve looked at 
how to print program output to the terminal, 
but in order to interact with the user, this 
needs to be a two-way process. This instalment looks 
at how we can read and interpret input that the user 
enters in the terminal. 

The printf is the standard way of writing formatted 
text output from a program, but how can we read what 
the user types in? 

In the last instalment, we looked at the sscanf 
function, which reads values from a string. There’s 
an equivalent function called scanf, which reads 
values typed in by the user: 


1 
2 

3 

4 

s int argl, arg2: 
6 

7 

8 

9 


Above The argc and argv arguments to the main function can 
be used to access parameters typed on the command Line 
when the program is run 
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#include <stdio.h> 


void main (void) 
{ 
char input[256]; 
int age; 


printf ("What is your name, user?\n"); 
scanf ("%s", input); 


printf ("How old are you, %s?\n", input); 
scanf ("%d", &age); 


printf ("%s, you're %d?\n", input, age); 


scanf works exactly like sscanf, but has one fewer 
argument, as it reads from the keyboard rather than 
from a string. 

However, it’s not the best way of getting input, as 
it relies on the user doing what you expect, and this 
doesn’t always happen! (For example, in the code 
above, if the user types in 257 characters when asked 
for their name, they will overflow the space allocated 
for the input string, and bad things may happen...) 


A better way 
A better approach is to read each line the user enters 
into a buffer string, and then use sscanf to read 
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values from that string. The C library function fgets 
is useful for this. See the following example: 


#include <stdio.h> 


void main (void) 

{ 
char input[256], name[256]; 
int age; 


printf ("What is your name, user?\n"); 
fgets (input, 256, stdin); 
sscanf (input, "%s", name); 


printf ("How old are you, %s?\n", name); 
while (1) 
{ 
fgets (input, 256, stdin); 
if (sscanf (input, "%d", &age) == 1) 
break; 
printf ("Not an age, try again!\n"); 
} 


printf ("%s, you're %d?\n", input, age); 


fgets takes three arguments. The first is the buffer 
into which it should store the input. The second is 
the maximum number of bytes it will write into that 
buffer, which is useful to prevent overflow situations 
like that mentioned above. The third tells it where to 
read from — in this case, stdin (short for ‘standard 
input’) is the keyboard. 

When we ask the user for input, we use fgets to 
read up to 256 characters of whatever they type (up 
to the point at which they press the ENTER key), and 
we then use sscanf to interpret it. When asking for 
the user’s age, we use the value returned by sscanf 
to check that the user has entered what you expect, 
and loop until they give a valid answer. This makes 
it easier to handle the cases where the user types 
something unexpected! 


Reading parameters 

There’s another way to get input to your program, 
which is to supply it as a parameter when you start the 
program from the command line. We’ve always shown 
the main function as 


void main (void) 


This works, as you’ve seen, but it isn’t strictly 
correct. The strict definition of main looks like this: 


int main (int argc, char *argv[]) 


But if you’d seen that in instalment 1, you’d have 
runa mile, wouldn’t you? 
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main returns an integer — this is a success or failure 
code which some operating systems can use for 
processing in a shell script or the like. Traditionally, 
if a program succeeds, main returns 0; if it fails, it 
returns a non-zero error code. For programs that run 
on their own, you don’t need to worry about it! 

argc is the number of parameters given on the 
command line after the program name. This number 
includes the program name itself, so it’s always 1 or 
more; if parameters are provided, it will be 2 or more. 

char *argv[] is an array of strings, and each string 
is one of the parameters. 

It’s probably easier to understand that in practice, 
so here’s an example: 


#include <stdio.h> 


int main (int argc, char *argv[]) 
{ 
int param = Q@; 
while (param < argc) 
{ 
printf ("%d is %s\n", param, argv[param] ) ; 
param++; 


} 


return @; 


Try running this as before, just by typing its name. 
Then try typing other things after the name on the 
command line and see what it prints. 

Here’s an example of a simple calculator written 
using parameters: 


#include <stdio.h> 


int main (int argc, char *argv[]) 
{ 
int arg1, arg2; 
if (argc == 4) 
{ 
sscanf (argv[1], "%d", &arg1); 
sscanf (argv[3], "%d", &arg2); 


if (*argv[2] == '+') printf ("%d\n", 
if (*argv[2] == '-') printf ("%d\n", 
if (*argv[2] == 'x') printf ("%d\n", 
if (*argv[2] == '/') printf ("%d\n", 
} 
return 0; 


} 


argv[2] is the second parameter; this is a string, 
but we’re only interested in the first character, so we 
use *argv[2] to get this. 

Make sure you separate the arguments from the 
operator with spaces so they are identified as separate 
parameters — <progname> 2 + 2 rather than 
<progname> 2+2. 


argl 
argl 
argl 
argl 


Tutorial 


LEARN TO 
CODE WITH C 
BOOK 


Want to learn 
more C? You 
can find the 
entire series 
and more in 
the Learn to 
Code with C 
Essentials 
book, available 
digitally and 
in print now 
at magpi.cc/ 
learn-c-book 


LEARN 


C 


STDIN AND 
STDOUT 


We talk about 
‘stdin’ in this 
article, which is 
the ‘standard 
input’ stream 

- what the 
user types at 
the console. 
You may 
sometimes see 
references to 
‘stdout’, which 
is the ‘standard 
output’ stream 
- as you might 
expect, this is 
output which 

is printed to 
the console, 
usually 

via printf. 


+ arg2); 
- arg2); 
* arg2); 
/ arg2); 
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Tutorial WALKTHROUGH 


GERMANO CESARI 


CEO and Glise lead developer 
at twistednormal ltd. Writes 
code for a living, smokes ribs 
for pleasure. 
twistednormal.com 


MODEL A SQUI 
WITH 


How to get started with 3D modelling and turn your Raspberry Pi 


> Raspbian 


> Glise 
magpi.cc/ 
2kqaliq 


> Experimental 
GL drivers 
magpi.cc/ 
2knRTvS 


> Three-button 
mouse 


into a personal graphic workstation 


uring the last few years, 3D applications 

have been behind many achievements 

in computational and video hardware, 
addressing whole new branches of computer graphics. 
Once known as 3D modelling applications, these 
packages are now best described as fully fledged 
modelling suites, with ever-higher hardware 
requirements and steeper learning curves. We want to 
take a step back and focus on pure 3D modelling using 
Glise, a new free modeller with minimal hardware 
requirements and a painless interface. Built from 
scratch, it turns a Raspberry Pi into a true modelling 
tool. So let’s get started and see what your Raspberry 
Pi can do! 


We will create a coarse sketch, 


add fins, eyes, and tentacles, 
then tweak as needed 


and tentacles 
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Extrude faces and bevel 
edges to add eyes, fins, 


Set up and install 

You must first activate the experimental OpenGL 
drivers — find out how on the Raspberry Pi website 
here: magpi.cc/2knRTvS. You might also want to 
increase the GPU memory to 128MB. 

Download Glise for Raspberry Pi from 
twistednormal.com, right-click on the downloaded 
installer, and select Package Install. 

Avoid any LXDE/Glise key binding conflict (they 
both use Alt+mouse drag). You can either edit 
~/.config/openbox/Ixde-pi-re.xml and comment 
out the whole <context name="Frame"> section, or 
simply press the Function (Windows) key when using 
the Alt key to move the camera in Glise. 


Refine your model and adjust 
the pose using soft selection 
and tweak mode 
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| Fig 2 Basics of tweaking a face: 
a) selection and handle 
b) translation 
c) scale 


What we are going to do 
3D modelling is an iterative process where you push, 
pull, and tweak vertices, edges, and faces. But how do 
you turn simple, geometrical primitives into an alien 
spider, a flying mussel, or a panda playing a banjo? 
As any good artist, you will start by sketching out 
the basic proportions of the model using a very coarse 
mesh, which has only few components and allows 
you to make big changes quickly. As your modelling 
session progresses, you’ll work on increasingly 
complex details, adding new, smaller components, 
either locally or by subdividing your whole model. 
We’re going to draw a squid, since they’re relatively 
easy to model, yet complex enough to let us cover 
several fundamental concepts. 


Modelling basics 

Instead of going ahead with an endless list of actions 
to perform, like ‘click there’, ‘open that’ and the 
like, let’s go through the fundamental concepts 

and procedures needed to sketch the squid head, 
which, surprisingly enough, you’ ll be able to model 
all by yourself once you’ve grasped the basics. You 
might want to check the online documentation at 
magpi.cc/2knLzo2 (and you definitely should) while 
practicing, to get more in-depth information about 
the topics discussed here. 

Glise’s main window may contain several 
independent viewports, each holding either a scene 
manager, a Python console, or a modelling canvas 
(an ambient occlusion renderer is also available on 
Linux and Windows). Since we’re not going to deal 
with scene management or Python programming, 
we will focus on the modelling canvas, which, as the 
name implies, is where all the magic happens. You 
can easily spot a modelling canvas from the little axis 
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gizmo on its lower-right corner. By default, Glise 
will use a single, full-screen modelling canvas. If you 
want to change the default layout, check the online 
documentation at ‘Layouts, Viewports and Dialogs’. 
Creating a cube is straightforward: use a right 
mouse button (RMB) click anywhere in a modelling 
canvas to open the pop-up menu, and select Create 
> Cube. Now that there is an object in the scene, 
you can move the camera by pressing the ALT key 
and dragging the left mouse button (LMB) to rotate, 
the middle mouse button (MMB) to pan, or the RMB 


STICKY 
KEYS 


Focus on the modelling 
canvas, which is where all 
the magic happens 


to zoom. Whenever the Alt key is pressed, drag 

the mouse to move the camera. Any time you want 

to centre the cube, just press Space and it will be 
framed in the current canvas. Practise with these 
controls: moving the camera and framing things must 
become second nature. See ‘Navigation’ in the online 
documentation for more camera controls. 

All this is fine and dandy, but you won’t get very 
far just by rotating a camera around a cube. So we’re 
going to tweak a face, which is, yes, modelling! Left- 
click on a face to select it. As the face turns yellow, a 
3-axis handle is placed right on its centre (Fig 1-a). 
You can now LMB-drag any of the arrows to translate 
the selection along a direction (Fig 1-b), or LMB- 
drag the centre of the handle to move it freely. Try 
it! Dragging an arrow with the middle mouse button 
will make you scale the selection along a direction. 
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Coarse head MMB-drag the centre of the handle for a uniform 
sketch reference: ; : : 
a) from the front scale on every axis (Fig 1-c). Left-click on an empty 
b) from the back area to clear the selection. Play with the handle 
and get comfortable with translating and scaling, 
change the type of components you can select and 


tweak (press A, S, D, G to switch to points, edges, 


When you model a base mesh, 
Glise automagically takes care 
of its subdivided surface 


faces, or mixed), and remember that a simple Ctrl+Z 
will undo any unwanted change. Check the online 
documentation at ‘Preselection, Selection & Soft 
Selectior’ and ‘Handles & Tweaking’ to learn more 
about selections and tweaking. 

Now one last, quick step: select a cube face and 
press X. You’re currently using the extrude tool 
to perform a face extrusion. Move the mouse left 
and right to slide the newly created face and use a 


Fig 3 Adding fins: 

a) edge selected 

b) after edge bevel 

c) during face extrusion 
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single right mouse button click to exit tool mode. 
Again, Ctrl+Z is your friend if you mess things up. 
Congratulations - you know a lot of stuff now! 


Sketching the head 

So you know how to create a primitive, rotate the 
camera, tweak components, and extrude faces. Believe 
it or not, you can easily model our target shape in 

Fig 2 all by yourself. You can skip this if you managed 
to model something close enough. Otherwise, this 

is how to proceed in five easy steps: create a cube, 
extrude a side face slightly outward, scale it smaller, 
and extrude it inward. Scale the opposite face smaller. 
Isn’t modelling awesome? 

We know what you’ re thinking: if that’s a squid 
head, what on earth have we been eating? Don’t 
worry; let us introduce you to the wonderful world of 
subdivision. Subdivision is the process of applying a 
specific set of rules to generate a more complex mesh 
from a simpler object. Glise handles each object as 
if composed of two distinct yet entangled entities: 

a base mesh and its subdivided surface. When you 
model a base mesh, Glise automagically takes care of 
its subdivided surface in real time. You may change 
the display mode of a modelling canvas by pressing 

1 to see only base meshes, 2 to see only subdivided 
surfaces and work directly on them (the default), or 3 
to see both. 

Now press PgUp twice to increase the display 
approximation level of the surface of our sketch. 
Isn’t it starting to look like a squid? Keep in mind 
that each level will eat four times more memory (and 
video memory) than the previous, so depending on 
the complexity of your model, you might not want 
to go further than a couple of levels. Use PgDn to get 
back to the previous level. See ‘Introducing Glise’ and 
‘Display’ in the online documentation to learn more 
about what we’ve just covered. 
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Eyes, fins, and tentacles 

Well, we’re done now with our rough sketch, 

and it’s time to proceed to the next level. We want 
to add a few details. Unfortunately, our base mesh 
(the one you actually model) is basically still very 
close to a simple cube. We can’t extrude fins and 
tentacles from a cube’s face, because we need 
components to work with, and in the middle of a 
face there’s only, well, a face. So follow us, and 
everything will be clear in a minute: press F to 
switch to object selection mode, select our object, 
and press Shift+PgUp (aka ‘Refine’ ). This will replace 
our base mesh with the first approximation level 
of its subdivided surface, which will keep its shape. 
Now our model has way more components, and we 
can have our fins in the right place. But wait: squids 
have a symmetrical body. Let’s work on one side 
and have Glise take care of the other! We just have 
to properly set up symmetry on our squid: press S 
to switch to edge selection mode, and select one 

of the edges dividing the left side from the right. 
Press Alt+C (Symmetry > Compute From > Edges) 
and that’s it. Isn’t symmetry great? If instead you 
received an error message, check that the edge 

you selected really lies on the centre of the model. 
There are also other ways to compute symmetry 

— check ‘Symmetry’ in the online documentation 
to learn more. 

Back to the fins: now that we’ve refined our 
model and enabled symmetry, select an edge like 
Fig 3-a and press B to use the edge bevel tool. 

Slide the mouse like in Fig 3-b and right-click to 
exit tool mode. Now select the newly created face 
and extrude it as in Fig 3-c. We’1l make something 
similar for the tentacles, but we will work with 
vertices: press A to switch to vertex selection 
mode, select the vertices as in Fig 4-a, and press 
Ctrl+B to use the bevel tool on those. Right-click to 
exit tool mode when you’re close to Fig 4-b. Then 
all we need to do is extrude the newly created faces 
as in Fig 4-c. Create the eye by using the bevel tool 
on a single vertex and deleting the resulting face 
with Del. 

Now it’s just a matter of tweaking a bit and 
working on a few further extrusions, and your final 
result will be very much like the squid in our picture. 
It doesn’t have to be exactly the same — it must be 
what you want it to be. 


What now? 


Well, this is quite a complex subject, and this short 
tutorial wasn’t meant to cover everything. There 

are tons of books, online tutorials, and videos on 
each single topic related to 3D modelling. Still, the 
tools you used in these pages can be found in any 3D 
software package, and the fact that you’re doing this 
on your Raspberry Pi is awesome! Now draw and be 
creative, but above all, have fun! 
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TOOLS AND 
PRESELECTION 


Adding tentacles: 
a) vertices selected 
b) after vertex bevel 
c) during face extrusion 
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I) Sonic Pi 


SUBTRACTIVE 
SYNTHESIS 


Learn more ways to design sounds in Sonic Pi thanks to Sam Aaron 


52 


Raspberry Pi 
running Raspbian 


Sonic Pi v2.9+ 


Speakers or 
headphones with 
a 3.5mm jack 


Update Sonic Pi: 
sudo apt-get 
update && sudo 
apt-get install 
sonic-pi 


his is the second in a series of articles on how 
to use Sonic Pi for sound design. Last month 
we looked at additive synthesis, which we 
discovered was the simple act of playing multiple 
sounds at the same time to make a new combined 
sound. This month we’ll look at a new technique 
commonly called subtractive synthesis, which is 
simply the act of taking an existing complex sound 
and removing parts of it to create something new. 
This is a technique which is commonly associated 
with the sound of analogue synthesizers of the Sixties 
and Seventies, but also with the recent renaissance of 
modular analogue synths through popular standards 
such as Eurorack. 

Despite this sounding like a particularly 
complicated and advanced technique, Sonic Pi makes 
it surprisingly simple and easy — so let’s dive right in. 


Complex source signal 
For a sound to work well with subtractive synthesis, it 
typically needs to be fairly rich and interesting. This 
doesn’t mean we need something hugely complex — in 
fact, just a standard : square or : saw wave will do: 
synth :saw, note: :e2, release: 4 
Notice that this sound is already pretty interesting 
and contains many different frequencies above :e2 
(the second E on a piano), which add to create the 
timbre. If that didn’t make much sense to you, try 
comparing it with the : beep: 


synth :beep, note: :e2, release: 4 

As the : beep synth is just a sine wave, you’ ll 
hear a much purer tone and only at :e2 and none 
of the high crispy/buzzy sounds which you heard in 
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the : saw. It’s this buzziness and variation from a 
pure sine wave that we can play with when we use 
subtractive synthesis. 


Filters 

Once we have our raw source signal, the next step is 
to pass it through a filter of some kind, which will 
modify the sound by removing or reducing parts of it. 
One of the most common filters used for subtractive 
synthesis is something called a low-pass filter. This 
will allow all the low parts of the sound through, but 
will reduce or remove the higher parts. Sonic Pi has a 
powerful yet simple-to-use FX system that includes a 
low-pass filter, called :1pf. Let’s play with it: 


with_fx :lpf, cutoff: 100 do 
synth :saw, note: :e2, release: 4 
end 


If you listen carefully, you’ll hear how some of that 
buzziness and crispiness has been removed. In fact, 
all the frequencies in the sound above note 10@ have 
been reduced or removed, and only the ones below are 
still present in the sound. Try changing that cutoff: 
point to lower notes, say 7@ and then 5®, and compare 
the sounds. 

Of course, the :1lpf isn’t the only filter you can use 
to manipulate the source signal. Another important 
FX is the high-pass filter, referred to as :hpf in 
Sonic Pi. This does the opposite to :1pf in that it lets 
the high parts of the sound through and cuts off the 
low parts. 


with_fx :hpf, cutoff: 90 do 


synth :saw, note: :e2, release: 4 
end 
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Notice how this sounds much more buzzy and raspy 
now that all the low-frequency sounds have been 


synth :prophet, note: :el ~ 
removed. Play around with the cutoff value —- note 
how lower values let more of the original bass parts ! | 
of the source signal through and higher values sound BI 
increasingly tinny and quiet. 
with_fx :lpf, cutoff: 70 do 
e synth :prophet, note: :el 
Low-pass filter end 
The low-pass filter is such an important part fe 
of every subtractive synthesis toolkit that it’s with_fx :lpf, cutoff: 5@ do 
worth taking a deeper look at how it works. This synth :prophet, note: :el ——~ — : 
end 


diagram (top right) shows the same sound wave 
(the : prophet synth) with varying amounts of 
filtering. At the top, section A shows the audio 
wave with no filtering. Notice how the wave form 
is very pointy and contains lots of sharp edges. It 
is these hard, sharp angles that produce the high 
crispy/buzzy parts of the sound. Section B shows 
the low-pass filter in action — notice how it is less 
pointy and more rounded than the wave form 
above. This means that the sound will have fewer 
high frequencies, giving it a more mellow, rounded 
feel. Section C shows the low-pass filter with a 
fairly low cutoff value —- this means that even more 
of the high frequencies have been removed from 
the signal, resulting in an even softer, rounder 


SUBTRACTIVE SYNTHESIS 
A 


you to directly name and control the running FX 
synth. Line 2 does exactly this and controls the FX to 
set the cutoff_slide: opt to 3 and the new target 
cutoff: to be 130. The FX will now start sliding the 
cutoff: opt’s value from 5@ to 130 over a period of 
three beats. Finally, we also trigger a source signal 
synth so we can hear the effect of the modulated 
low-pass filter. 


Bringing it all together 
This is just a very basic taster of what’s possible when 
you use filters to modify and change a source sound. 


wave form. Finally, notice how the size of the wave Try playing with Sonic Pi’s many built-in FX to see 
form, which represents the amplitude, decreases as what crazy sounds you can design. If your sound feels 
we move from A to C. Subtractive synthesis works too static, remember you can start modulating the 


by removing parts of the signal, which means that 
the overall amplitude is reduced as the amount 
of filtering that is taking place increases. 


Filter modulation 


So far we’ve just produced 
other words, the sound doe 
the entirety of its duration. 
some movement in the sou 


fairly static sounds. In 


sn’t change in any way for 
Often, you might want 
nd to give the timbre some 


options to create some movement. 
Let’s finish by designing a function which will play 

a new sound created with subtractive synthesis. See 

if you can figure out what’s going on here - and, for 

the advanced Sonic Pi readers out there, see if you can 

work out why we wrapped everything inside a call to 

at (please send answers to @samaaron on Twitter). 


define :subt_synth do |note, sus| 
at do 
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qanquage 


>RUBY 


Above How the 
waveform alters 
when a low-pass 
filter is added wit 
two cutoff values 


h 


with_fx :lpf, cutoff: 40, amp: 2 do |fx| 
control fx, cutoff_slide: 6, cutoff: 100 
synth :prophet, note: note, sustain: sus 
end 
with_fx :hpf, cutoff_slide: @.01 do |fx| 
synth :dsaw, note: note + 12, sustain: sus 
(sus * 8).times do 
control fx, cutoff: rrand(70, 110) 
sleep @.125 


life. One way to achieve this is via filter modulation — 
changing the filter’s options through time. Luckily, 
Sonic Pi gives you powerful tools to manipulate an 
FX’s opts through time. For example, you can set a 
slide time to each modulatable opt to specify how long 
it should take for the current value to linearly slide to 
the target value: 


with_fx :lpf, cutoff: 50 do |fx| 


control fx, cutoff_slide: 3, cutoff: 130 end 
synth :prophet, note: :e2, sustain: 3.5 end 
end end 
end 
Let’s take a quick look at what’s going on here. 
Firstly, we start a : lpf FX block as normal with an subt_synth :e1, 8 
initial cutoff: of alow 50. However, the first line sleep 8 


also finishes with the strange |fx| at the end. This is 
an optional part of the with_fx syntax which allows 


subt_synth :e1 - 4, 8 
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BUILD LOGIC GATES WITH 


GPIO ZERO 


SQURCE/VALUES 


Learn how you can use source/values in GPIO Zero to easily connect 
devices together using a declarative style of programming 


The latest version 
of GPIO Zero 
magpl.cc/ 
2kmDusl 


Full-size 
breadboard 


3xLEDs 
3 x 330Q resistors 
2 x push buttons 


7 x male- 
to-female 
jumper wires 


2 x male-to-male 
jumper wires 


LEDs represent OUT1, 
OUTz2, and OUT3 


ource/values is a more advanced feature 

of GPIO Zero, but it’s incredibly powerful 

and much simpler than you’d think! You 
can do more with less code, and it saves you from 
using while loops to keep updating the state of your 
devices. This clever concept allows you to describe 
how devices should behave, making your code 
more concise. 

Source/values is easy to get started with, and takes 

a keen mind to master. There’s some magic going on 
beneath the hood! You will learn how it all works, and 
put it into action by creating logic gates (AND, OR, 
and NAND), using LEDs and buttons. 


Buttons represent 
INa and IN2 


Each button and LED is connected 
to ground (GND) and a GPIO pin 
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What is source/values? 
GPIO Zero is more than just a friendly API: it 
comes with some powerful tools for helping you 
program your next project. While you can start 
with simple procedural code, where each line is 
followed in sequence, you can progress to event- 
driven programming, meaning various events can 
be triggered in any order, or at the same time. And 
finally, the darkest of dark arts, source/values brings 
forth a third programming paradigm: declarative. 
This means you describe an object’s behaviour in 
one line, and it will follow that instruction in the 
background. This is really handy if you have lots 
of things going on at once! 

Source/values is the name for the concept 
in GPIO Zero for telling a device how it should 
behave, or for connecting up multiple devices 
together so they act ina particular way. Every 
GPIO Zero device has a . value property which 
you can read at any time: a button will tell 
you if it’s pressed (True) or released (False), 
and an LED will tell you if it’s lit (True) or not 
False). Output devices (like LEDs) can have their 
value set; led. value = True will light the LED, 
just like using led.on(). 
Every device also has a .values property, which 
is an iterator constantly yielding the current value. 
Output devices have a . source property which 
is where you tell the device where it should get 
its values from. Commonly, this will be another 
device’s .values property, which is an easy way of 
connecting two devices together. For example, 
led.source = button.values means the LED will 
be on when the button is pressed. 


raspberrypi.org/magpi 


source_values.py 


from gpiozero import LED, Button 

from gpiozero.tools import all_values, any_values, negated 
from signal import pause 

in_1 = Button(@) 

in_2 = Button(1) 

out_1 = LED(2) 

out_2 = LED(3) 

out_3 = LED(4) 


out_1.source 
out_2.source = 
out_3.source 


negated(out_1.values) 


pause() 


The magic under the hood 

This concept was developed by Dave Jones (author 
of the picamera library and co-developer of GPIO 
Zero) based on an idea formed in a GitHub issue 
rpf.io/gpz76). The way it works is that when a 
device’s source is set, a background thread is created 
to constantly set the device’s value to the next item 
in the iterator. If source is set to another device's 

- Values, this is effectively always reading the other 
device’s current value. It doesn’t have to be, though: 
it can be any iterator, or you can write your own 
function to send values to the device. 

A handy thing about GPIO Zero is the fact that 
devices tend to have a standard value range — usually 
a sliding scale from 0 to 1 (or True and False, which 
are effectively just 0 and 1). This means that you can 
pass the values from one device into another: like a 
potentiometer (0-1) into a PWM LED (0-1) to dial up 
the brightness. Exceptions include Motor, which goes 
from -1 to 1(-1 being full speed backwards, 1 full speed 
forwards), and composite devices like Robot, which is 
a tuple (-1, -1) to (1, 1) for left and right motor speeds. 


Why is it useful? 

Using this method of connecting devices is much more 
concise. Rather than using a while loop (five lines) to 
constantly check if a button is pressed to turn an LED 

on or off, or using an event-driven approach (two lines: 
when_pressed and when_released), one line tells it to 
match the button: led.source = button.values. 

As well as connecting two devices directly together, 
you can process the value in between, using a custom 
function. GPIO Zero provides a set of commonly 
used tools for this kind of processing. Importing the 
negated function from gpiozero. tools allows you to 
specify that an LED should be lit when the button isn’t 
pressed: led.source = negated(button.values). 
See more source tools in the docs at rpf.io/st. 
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all_values(in_1.values, in_2.values) 
any_values(in_1.values, in_2.values) 


BUILD LOGIC GATES 


Source/Values 


© Seurce/Values 


Programming logic gates 

Let’s begin. First, wire up two buttons and three 
LEDs on a breadboard. You’!1 need to import the 
gpiozero LED and Button classes, and the all_ 
values, any_values, and negated source tools. 
C 
b 


>PYTHON 


DOWNLOAD: 


magpi.cc/ 
ZeroSourceValues 


reate objects representing each of the LEDs and 
uttons, providing the pin numbers they’re wired 
to. The buttons represent two inputs; the LEDs three 
outputs. You’re going to program the first LED to 
represent the binary AND of the two inputs, the 
second to represent the OR, and the third the NAND. 
To define the AND of the two buttons, you’ll need to 
use the all_values function from gpiozero. tools; 
all_values yields True if all of the inputs are True, 
which is an AND gate: 


Above Read up 


in the gpiozero 
documentation 
at rpf.io/sv 


out_1.source = all_values(in_1.values, in_2.values) 
To define the OR of the two buttons, you can use the 
any_values source tool; any_values yields True if 
any of the inputs are True, like an OR gate: 
out_2.source = any_values(in_1.values, in_2.values) 
You could define the NAND button using a 
combination of negated and all_values, but since you 
have already calculated the AND, you can simply read the 
state of the AND LED and negate that: 
out_3.source = negated(out_1.values) 
Finally, if you’re running this code from a file rather than 
a Python shell, the last line, pause( ), will keep your script 
running. Run your code and you’!l see the NAND LED lit up. 
That’s because (with no buttons pressed), it’s the only gate 
that’s active according to the rules. Try pressing the buttons 
in different combinations to check your logic! Now try 
programming some more logic gates: XOR, NOR, and XNOR. 
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CARRIE ANNE PHILBIN 


Carrie Anne is the director of education 
at the Raspberry Pi Foundation 

and also the author of Adventures 

in Raspberry Pi. 
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MAKE A etowete: 


PROJECT ., 


Enter the Pioneers 
challenge here: 


> 2x crocodile clips 


> 2x male-to- 
female jumper 
leads 


> Aspeaker 


> Craft stuff: 
paper plates, 
cardboard, 
aluminium foil, 
glue, scissors, 
sponge, bulldog 


Mamwenem A Pi- powered retro prank, perfect to get your mind thinking 
about a Pioneers project! 


n the bad old days before TV and computers, ‘PARP! noise, causing him to jump into the air and 

the most popular form of family entertainment making his false teeth fly out. It was the best thing 

was the whoopee cushion, a tooty balloon ever. This project brings the whoopee cushion up to 
originally made from a pig’s bladder. The whoopee date: there’s no bladder and no need to blow it up. 


cushion would be inflated and hidden under Grandad’s Thanks to the Raspberry Pi, you can also add whatever 
chair cushion. When he sat down, it would makealoud _ noises you want! 


Behind the sofa may not 
be the best place to hide, 
but you'll need to see your 
prank in action 


This look of discontent 
is what every prank 
should strive for 


An electrically 

powered trump 
machine, ready 
to prank 
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Making the Whoopi cushion 

Cut a circle from the cardboard to fit the centre of the 
‘eating’ side of each paper plate. Tape or stick squares 
of foil onto the cardboard. These are your contacts: 
when they touch, they will complete a circuit. Using 
some copper tape, connect the foil to the edge of the 
plate. Chop the sponge up into cuboid chunks and 
glue them around the foil on one of the plates: this 
will stop the foil squares touching each other until 
someone sits on the plate. It should look something 
like Fig 1. 

Put the two plates together so that the foil pieces 
are on the inside and facing each other. Offset the 
paper plates so that the copper tape sections are 
not touching. 

You now have a ‘cushion’ made of two plates. You 
can tape the plates together, or you might choose to 
use bulldog or paper clips so that you can test that 
your cushion works correctly, and easily debug any 
hardware problems. 


Connect the Whoopi cushion to the Pi 
Plug one header lead (it doesn’t matter which) onto 

a ground (GND) pin on the Pi (refer to Fig 2). Plug 

the other wire onto GPIO pin 2 (Fig 3, overleaf) and 
then clip a crocodile clip cable to one of the paper 
plates’ copper tape sections. Connect the other end of 
the crocodile clip cable to the male pin of one of the 
connected jumper wires (Fig 4). Repeat these last two 
steps to connect the other plate to your Raspberry Pi. 
Your setup should look similar to Fig 5. 
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Test the sound 

That’s the hardware complete. Now for the software! 
We’re going to use Python. Don’t worry if you haven’t 
used it before: just follow the instructions and you’ ll 
pick it up. You’1l be using the command line to enter 
commands. To do this you’1l need to open a terminal 
window by clicking on the terminal icon: it looks like a 
computer screen, and is found three icons along from 
the Menu button on your desktop. 

Connect the speaker to the Raspberry Pi using the 
sound jack. Create a new folder called whoopee by 
typing the following command in the terminal and 
pressing Enter on the keyboard: 
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Fig 2 It looks a bit 

like some futuristic 
tech. We'll use it to 
make farting sounds 


Fig 2 If you have 


Pi model you'll 


same layout 
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an older Raspberry 


only have 26 pins, 
but they have the 
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Fig 3 Again, 

this will be the 
same pin on any 
Raspberry Pi 
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mkdir whoopee 


Next, use cd whoopee to enter the folder you 
have just created. We’re going to need a sample 
sound file for this project, so we’ll use one from 
Sonic Pi. Download this burp sample using the 
following command: 


wget http://rpf.io/burp -O burp.wav 


Now, test that you can play the sound file using 
aplay by typing: 


aplay burp.wav 


You should hear it from the speakers or headphones 
connected to your Pi. If you can’t hear anything, make 
sure that your speakers are connected correctly. If 
this still doesn’t work, you’ll need to change your 
audio configuration. 


PIONEERS 


MAKE YOUR OWN PRANKS 
AND WIN! 


Think you can do better than this? The Raspberry 
Pi Foundation is running a competition for folks 
between 12 and 15, and all you need to do is make 
them laugh using digital technology. Sound easy? 
Sound fun? Then check out the website for more 
details: magpi.cc/2iHKIP5 
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Fig 4 It's avery 
simple step but 
best to get it right 


To switch audio to the headphone jack, return to the 
terminal window and type the following command: 


amixer cset numid=3 1 


If your Raspberry Pi is connected to the internet, 
you could search for some suitable trumping sounds. 
They need to be in WAV format to work. Alternatively, 
download our example sounds here: rpf.io/farts. 


Write a program in Python 

Open Python 3 (IDLE) from the Programming menu 
and click on File > New Window. This will open a blank 
file. Click on File > Save As, name the file whoopee.py 
and then type the following code into your file: 


import os 

import random 

from time import sleep 
from gpiozero import Button 


This part of the code pulls in all the libraries that 
yow re going to use to write your program. You’!] then 
need to use the Button class in your code. You’ll have 
to tell it that the button is on pin 2. To do this, write 
the following code in your new file: 

button = Button(2) 

Now create a list of all your sound effects and store 
them inside a variable that you can call later on in 
your code: 

trumps = ['ben-fart.wav', 'ca-fart.wav', 
"marc-fart.wav' ] 


In Python, square brackets are used to create a list. 
Each item in the list is separated by a comma. 

Once all the setup needed in the code is complete, 
you can move on to writing the part of the program 
that will make something happen when the button is 
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pressed. Begin by creating a loop using while True:. 
Then, add button.wait_for_press() inside the loop 
by indenting by four spaces. Each time around the 
loop, the computer waits for the button to be pressed. 

On the next line, use the random. choice function 
to select a sound at random from the list you created 
earlier. That selected sound needs to be stored inside 
another variable which you can call parp! Type parp = 
random. choice(trumps). 

The next line will play the sound selected at random 
using aplay, as used earlier when testing sounds. 
Type os.system("aplay {0}".format(parp) ). 
Finally, add sleep(2) to pause the program before it 
starts the loop again. Your code should look like this: 


while True: 
button.wait_for_press() 
parp = random.choice(trumps) 
os.system("aplay {@}".format(parp) ) 
sleep(2) 


Save the file by clicking on File > Save. Test that your 
code works by clicking on Run > Run Module. Use your 
hand to push the top plate of your Whoopi cushion 
down to make a connection between the foil sheets, 
and you should hear a fun sound. If it doesn’t work first 
time, don’t worry. Check your code through. Have you 
typed your code out exactly as you see it here? 
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Fig 5 Yours may be 
considerably tidier 
than this. Or messier. 
It’s all good 


qanguage 


>PYTHON 3 


whoopee.py 


import os 

import random 

from time import sleep 
from gpiozero import Button 


DOWNLOAD: 
magpi.cc/ 
WhoopiCushion 


button = Button(2) 
trumps = ['ben-fart.wav', ‘ca-fart.wav', ‘marc-fart.wav' ] 


while True: 
button.wait_for_press() 
parp = random. choice(trumps) 
os.system("aplay {@}".format(parp) ) 
sleep(2) 


Setting it up 

Carefully place your cushion in a spot where your 
victim will sit on it (obviously!), but not under a really 
heavy cushion where it will be squashed straight 
away. The tricky bit is setting up the Pi so that it 
can’t be seen: remember, you’!1 need a plug socket to 
connect it to the power, unless you’re using a battery 
pack. Run the program, and wait. Here’s a hint: 
whistle tunelessly and look around at the ceiling. This 
will make you seem innocent, and will help to attract 
potential victims. 
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Tutorial 


yy: a 


Exited 


See the current status of 
each process at a glance 


See a history of when processes 
exit to spot if there's any patterns 


Receive a text message or email 
whenever a process exits 


REMOTELY MONITOR 
YOUR PI PROCESSES 


Create a web-based dashboard of all your important processes and get 
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Initial State 
account 
magpi.cc/ 
2kiYp77 


a notification when one exits 


f you're using one or more Raspberry Pis to 
run_a dedicated task (e.g. weather station or 
monitoring your beer fridge), you need those 
processes to run uninterrupted. A task that exits 
unexpectedly may need your immediate attention 

to avoid lost data, project delays, or a system failure. 
It’s impractical, though, to manually babysit a bunch 
of Raspberry Pis. A better way to ensure continuous 
operation is to be alerted when a process exits, and be 
able to pull up a single dashboard to see the status of 
every important process running on every one of your 
deployed Raspberry Pis. 


Initial State 

We want to stream the status of each of our processes 
to a web service and have that service turn our data 
into a nice dashboard that we can access from our 
laptop or mobile device. Our data needs a destination, 
and we’ |] use Initial State as that destination. First, go 
to magpi.cc/2kiYp77 and create a new account. Next, 
install the Initial State Python module onto your Pi: 


cd ~ 
\curl -sSL https://get.initialstate.com/ 
python -o - | sudo bash 


Follow the prompts, including the step of creating a 
test script to ensure you can successfully stream data 
from your Pi. 
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Monitor a process 

Whenever you run a program or script on your Pi, 
you initiate a process. Each running process will 
have a unique process ID number (PID). You can see 
every process owned by you by typing ps at your Pi’s 
command prompt. You will see a response that looks 
something like this: 


PID TTY: 
TIME CMD: 


3359 pts/o 
00:00:01 bash 


3373 pts/o 
00:00:00 ps 


If you want to find every running Python process, 
you can use the following command: 


$ ps -ef | grep py 


root 2287 1 © Dece9 ? 
@0:00:08 sudo python /home/pi/weather/ 
weather. py 


In the example above, the PID of the weather 
Python script is 2287. Once we know the PID of the 
process we want to monitor, we can pass this number 
as a parameter into a simple Python script that 
will monitor the existence of this defined process 
and send either a ‘Running’ or ‘Exited’ response to 
our dashboard. 

We will use the Python script located at 
magpi.cc/2kj3BYs. Before we can use this script, 
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REMOTELY MONITOR YOUR PI PROCESSES 


we need to set each of our user settings at the top 
of the file. 


for monitoring our processes. However, we need to 
consider what happens when we have a power outage. 


>PYTHON 


Monitor a reboot DOWNLOAD: 


magpi.cc/2iUSsAY 


BUCKET_KEY specifies the data bucket our script 


will stream into. Make sure you use the same 
BUCKET_KEY for each script that should send data 
into the same dashboard. 


ACCESS _KEY is your unique Initial State account key. 
This key is used to send data into your account from 
the scripts. You can find your ACCESS_KEY in the 
Streaming Access Keys section of your Initial State 
account settings. 


PROCESS_NAME is the name of the specific process 
you’re monitoring that you want to display on 
your dashboard. For example, PROCESS_NAME = 
"Franklin Weather Station". 


You can run this script as follows: 
python monitor_process.py <pid> 

To run this in the background without interruption: 
nohup python monitor_process.py <pid> & 


Manually finding the PID is cumbersome. Let’s 
make it a bit easier by creating another simple script 
that will find the PID automatically and launch our 
monitor_process script. 


Launch a monitored process 

We can use a Simple Bash script to do three things: 

launch our important task/program/process, find the 

PID of the task/program/process we just launched, 

and pass the PID into our monitor_process script. 
The Bash script that we’ll modify and use is located 

at magpi.cc/2kiS23q. 

To use this script, simply modify the two user 

settings at the top of the file: 


PROCESS2RUN is the process you want to run and 
monitor. Specify the full path. 


MONITOR_SCRIPT is the monitor_process.py script we 
just created. Again, specify the full path. 


Before you run this script, you’ll need to make it an 
executable file. Run the following: 


chmod u+x launch_process.sh 
To run the script: 
-/launch_process.sh 


We could stop here and have a pretty good solution 
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If power drops, our process will instantly die, as will 
our monitoring script and network connection. On 
reboot, we need to do two things: send an update to 
our process dashboard that our process exited, and 
automatically start our process and process monitor 
after the reboot completes. 

First, let’s create a script that will run on reboot to 
send a ‘process exited’ status to our dashboard. We’1l 
use the script at magpi.cc/2kiTfla. The user settings 
at the top of this script need to be set just like the 
other scripts. Make sure you use the same BUCKET_ 
KEY, ACCESS_KEY, and PROCESS_ NAME as in the 
‘Monitor a process’ step. Once this script is set up, 
we need to call it automatically on reboot. 


Automatically launch on boot 
To automatically launch our scripts on boot, we will 
use crontab: 


crontab -e 


At the end of the file that opens, add the 
monitor_reboot script and the launch_process 
script. Specify the full path. For example, you’ ll add 
a single line that looks something like the following 
(with your specific paths): 


@reboot python /home/pi/weather/monitor_ 
reboot.py && /home/pi/weather/launch_ 
process.sh 


Notice the monitor_reboot script is followed by 
&&. This specifies that the monitor_reboot script 
should complete before the next command runs. If 
there’s a power outage, it may take a few minutes 
for your network connection to be restored. After the 
delays specified in the monitor_reboot script expire, 
status updates will be sent to your dashboard and 
your process will be launched. 

Once this is in place, everything will be automated. 
Every time your Pi boots, your process dashboard 
will update, and your process will launch and 
be monitored. 


Dashboard and notifications 

Each process that you monitor will add a data tile to 
your dashboard. This can be extremely useful if you 
have an application where multiple Pis are deployed 
across multiple locations. For example, if a Pi is used 
to monitor temperature in every room in your office 
building, you can quickly see the status of every Pi ata 
glance. You can enable SMS and/or email notifications 
for each process status by going to the Triggers section 
of your data bucket settings. 


INITIAL STATE 


Initial State is 
an easy-to- 
use platform 
for collecting 
data from 
connected 
devices and 
turning that 
data into 
dashboards, 
waveforms, 
notifications, 
and more. 
initialstate.com 
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FREQUENTLY 
ASKED QUESTIONS 


YOUR QUESTIONS ANSWERED 


NEEDA 
PROBLEM 
SOLVED? 


Email magpi@raspberrypi.org or 
find us on raspberrypi.org/forums 
to feature in a future issue. 


Your technical hardware and software problems solved... 


Right Raspberry Pi 
Configuration holds 
all the important 
Raspbian settings 


RASPBIAN 
INTERFACES 


PIXEL 

The graphical user interface (GUI) for Raspbian is the 
main way to use the Raspberry Pi. From here you can 
access traditional browsers, office suite apps, and the 
programming IDEs. This is the interface most people 
will use and the one which is recommended. 


Command line 

The classic command-line interface (CLI) requires you 
to input text commands and there’s very little in the 
way of graphics outside of ASCII art. You can control the 
Raspberry Pia bit more directly from here, while still 
being able to code. 


Custom interface 

You can also create custom interfaces for your Raspberry 
Pi: we’ve seen Python-powered phone-style interfaces 
you can use, and there are a few web-based interfaces 
around as well. The latter are very popular in CCTV or 
robotics applications. 


Filesystem: Expand Filesystem J 
Password: Change Password... 
posta == 
Boot: © To Desktop © ToCLI 
Auto Login: ¥ Login as user ‘pi’ 
Overscan: © Enabled © Disabled 
Rastrack: _ Add to Rastrack... | 
Cancel || OK | 
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Default interface 

You can select which interface to use by default from the 
Raspberry Pi Configuration tool under Preferences in the 
program menu. It is set to boot to the desktop by default, 
but you can also set it to boot straight into the command 
line if it suits your usage. 


Switch while running 

You can switch between the desktop and CLI while the Pi 
running. From the command line, using the command 
startx will boot up the desktop. From the desktop, you 
can quickly switch to a command-line interface using 
CTRL+ALT+F2. You can then switch back to the desktop 
interface with CTRL+ALT+F1. 


Custom interfaces 

Most custom interfaces, at least ones running directly 
from the Pi, require the desktop be running so it can use 
the graphical tools to display them. Keep that in mind 
while making something that turns on automatically at 
boot. Check what is required for web interfaces. 


Defaults 

By default, the Raspberry Pi will log you in whichever 
way you boot up. For most uses this is fine; however 
there will always be cases where this is quite insecure. 
As education is the main focus of the Raspberry Pi 
Foundation, though, this is why it’s turned on. 


Change it 

You can change whether or not the Pi automatically 

logs in. Go to the Raspberry Pi Configuration menu. 
Underneath the option to change which desktop it boots 
into, you’ll find the option to turn auto login on and off. 


Password 

For Raspbian, the default user name is piand the 
password is raspberry, so you’ll need to remember that 
if you turn off auto login. If you’re turning it off for 
security reasons, it’s a good idea to change the password 
as well. Find out how to do so here: magpi.cc/2iqm9pO. 
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What size SD card do | need for the Raspberry Pi? 
Whether you want to use the NOOBS installer or a 
standalone distro image, the minimum size SD card we 
recommend is 8GB. This will give you the free space you 
need to install extra packages or make programs of your 
own. The original Raspberry Pi Model A and Model B require 
full-size SD cards. The newer Raspberry Pi Model A+, Pi 
Model B+, Pi 2 Model B, Pi Zero, and Pi 3 Model B require 
microSD cards. 


What size SD cards can it support? 

We have tried cards up to 32GB, and most cards seem 
to work fine. You can also attach a USB stick or USB hard 
drive to provide extra storage. 


What happens if I brick the device? 
You can restore the device by reflashing the SD card. 


ADsHUnenl 


Will it run Android? 

No. While a version of Android can be found in the 
forum, it is not stable enough for everyday use. There 
are no plans to continue working on it, since Android 
does not provide any enhancement to educational 
purposes that are not already fulfilled more readily 
with existing software: we see it as a platform for 
consumption, not for creation. 


Will it run [insert name of program herel? 

In general, you need to look to see whether the program 
you want can be compiled for the ARMV6 (Pi 1) or ARMv7 
(Pi 2/3) architecture. In most cases, the answer will be 
yes. Specific programs are discussed on our forum, so 
you might want to look there for an answer. Ultimately, 
though, nothing beats grabbing a Raspberry Pi and 
finding out the answer through direct testing! 


WD PIDRIVE 
NOOO ZERO 


COMPACT AND PRE-ASSEMBLED 
WITH A HDD AND RASPBERRY PI ZERO. 


Build your own mini DLNA + Samba file server, wireless mobile 
storage device, or a Pi MusicBox with local storage, and more. 


Includes: 
¢ 314GB WD PiDrive, Raspberry Pi Zero, 
and custom adapter board 
e SD card with starter software 

e Mini HDMI adapter cable 


Learn more at wdlabs.wd.com/magpi55b 


© wDLaBs 


Western Digital, WD, the WD logo, WDLabs, and the WDLabs logo are registered trademarks or trademarks of Western Digital Corporation or its affiliates in the U.S. and/or other countries. Raspberry Pi is a trademark of the Raspberry Pi Foundation. microSD is a trademark of SD-3C, 
LLC. The term HDMI is a trademark or registered trademark of HDMI Licensing LLC in the United States and other countries. All other marks are the property of their respective owners. As used for storage capacity, one gigabyte = one billion bytes. Total accessible capacity varies 
depending on operating environment. Product specifications subject to change without notice. Pictures shown may vary from actual product. © 2017 Western Digital Corporation or its affiliates. 


Petite, efficient, and well connected. 
Meet the latest member of the Raspberry Pi family 


he big news this month is 

the introduction of a new 

computer model from the 
Raspberry Pi Foundation. 

The Pi Zero W is the same small 
revolutionary board that rocked 
the maker community, but it 
now packs built-in wireless LAN 
networking and Bluetooth. 

It also comes with an incredible 
new case. With switchable lids, 
this enables the Pi Zero W to 
function as a camera, provides 
access to its GPIO pins, or lets it act 
as a secure node. 
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A third of the size of a Raspberry 
Pi 3, the Pi Zero W still has enough 
power to run a full operating 
system like Raspbian. 

This update to the Pi Zero 
has the same small form 
factor, but crams in wireless 
LAN networking too. With the Pi 
Zero W, you can connect directly 
to a local wireless network without 
having to attach a USB dongle. 

The Pi Zero W gets the 
same wireless networking 
capabilities first deployed 
on the Raspberry Pi 3. 


Squeezing wireless networking 
onto a Pi Zero board hasn’t been 
easy, and the way Raspberry 
Pi went about it has shown 
considerable ingenuity. The new Pi 
Zero case is also a thing of wonder. 

But it’s what you can now do 
with a Pi Zero W that is going to 
make a difference. 

The Pi Zero W can connect 
automatically to a local network. 
With its small size and low-energy 
footprint, it’s ideal as a node for 
projects around the home, as well 
as loT and wearable projects. 
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PI ZERO 


Technical Specifications 
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65mm « 30mm x 5mm 

Broadcom BCM2835 

ARM11 running at 1GHz 

512MB 

2.4GHz 802.11n wireless LAN 
Bluetooth 4.1 LE 

5V, supplied via micro USB connector 


1080P HD video & stereo audio 
via mini-HDMI connector 


MicroSD card 

Micro USB 

40-pin GPIO, unpopulated 

Run mode, unpopulated; RCA composite, 


unpopulated 


Camera Serial Interface (CSI) 


|$10 [£9.so} €11_ 


feature 


he technology found in 
T the Pi Zero W is similar to 
that of the original Pi Zero, 
only now everything has had 
to make space for an incredibly 
smart radio antenna. This 
design enables the minute 
Pi Zero board to pack a complete 
wireless LAN and Bluetooth 
connection module. 
The Pi Zero W contains all of 
the technology from the original 
Pi Zero, but with a slightly 
redesigned board. 
The technical surge forward is 
thanks to the presence of 2.4GHz 
802.11n wireless LAN and Bluetooth 
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Pi ZERO W 


feature 


4.1 LE. These make the Pi Zero W 

much more accessible to makers. 
It reminded us how packed 

with technology the Pi Zero is. 

It features a full 40-pin GPIO 

header (unpopulated, so you will 


need to solder the pins on yourself). 


Two extra TV pins are used 
to connect the Pi Zero W to an 
RCA television, while two pins 
marked RUN can be used to plug 
in a reset button. 

A single USB On-The-Go 
connection allows you to hook up 
devices to the Pi Zero W, and the 
mini HDMI socket connects the 
board to monitors and TVs. 


To hook up stock cables, you’ ll 
want a Raspberry Pi Zero Adapter 


Kit (£4, magpi.cc/2kPZNzn) to get 


the most from your Pi Zero W. 


to the Pi Zero W. It’s especially 
pertinent thanks to the new case. 


The processor remains a 


Broadcom BCM2835 containing 


The Pi Zero W 1s a full computer, 
capable of running Raspbian and 
other Linux operating systems 


ACSI connection supports 
the Camera Module v2 
(magpi.cc/28IjIsz). This adds a 
Sony IMX219 8-megapixel camera 
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an ARM11 running up to 1GHz. The 
Pi Zero W is a full computer, capable 
of running Raspbian and other 


Linux operating systems. 


01. GPIO header 

Pi Zero W has the same 
40-pin GPIO header as the 
larger Raspberry Pi models, 
but it's unpopulated. Adding 
pins to the Pi Zero W board is 
a great first soldering project. 


02. Micro USB 

Asingle micro USB port is 
used to provide connectivity. 
Only now you don't need to 
add a USB WiFi dongle, so 
it'll be easier to connect justa 
keyboard and mouse. 


03. Micro USB power 
The second micro USB port 
is used to provide power 

to the board. 


04. Wireless LAN 

This triangular shape is 

used to boost the wireless 
connection. The signal 
bounces around the triangle 
and connects to the points at 
the bottom (before being fed 
up the pipes to the side). 


05. Bluetooth 4.1 

The Pi Zero also connects 

to Bluetooth 4.1. This 
connectivity makes it easy to 
hook up wireless devices and 
share files with the board. 


06. MicroSD card 
AmicroSD card is used to 
provide the storage for the 
Pi Zero W. 


07. Mini HDMI 

Amini HDMI connection 

is used to connect the 

Pi Zero W to a TV or monitor. 


08. RUN pins 

The two RUN pins can 
be used to wire up a 
reset button. 


09. TV pins 

The TV pins can be used 

to add an RCA video 
connection. Perfect for 
hooking up a Pi Zero W to 
older television sets (for retro 
gaming perfection). 


10. Camera Module 
Acamera port was added to 
the Pi Zero 1.3 and remains 
on the Pi Zero W. The Camera 
Module is tightly integrated 
with the Pi Zero thanks to the 
new case. 


11. Broadcom BCM2835 
This Broadcom BCM2835 
SoC is the heart of the Pi 

Zero W. It contains An ARM 11 
CPU running at up to 1GHz. 


feature 


oger Thornton is.the 

person in charge of the 

Raspberry Pi Zero W 
project: developing the new board 
has been a labour of love for him. 

The first Raspberry Pi product 

to gain wireless networking 
was the Raspberry Pi 3 (released 
shortly after the original Zero). 
Developing this product gave 
Raspberry Pi the experience 


THE 
PI ZERO 


“but we were getting better at 
squeezing features onto products, 
so we did a little playing around 
with the design.” According to 


Roger, there was a lot of “pushing 


and shoving” to fit all the 


components into a restricted area, 


and onto one side of the board. 
The Raspberry Pi 3 layout was 

based on a two-sided Broadcom 

reference design, with a ‘chip’ 


Theyre very clever boffins. 
It's areally neat design 


they needed to bring wireless 
networking to the Zero. 

There was no easy way the 
wireless layout from the larger 
Raspberry Pi 3 board would fit on 
the diminutive Zero. “We thought 
it was impossible,” muses Roger, 


antenna. In contrast, the Zero W 
uses a single-sided layout 
with a PCB antenna; this is the 
trapezoidal shape between the 
mini HDMI and micro USB sockets 
on the bottom edge of the board. 
“The Raspberry Pi 3 antenna is 
a surface-mount component,” 


explains Roger, “whereas the 
Zero W antenna is a resonant 
cavity which is formed by etching 
away copper on each layer of the 
PCB structure.” 


The technology is licensed from 
a Swedish company called Proant 
(you can see the credit on the 
reverse of the Zero W board). 
“They’re very clever boffins,” 
says Roger. “It’s a really 
neat design.” 


This free space is used to " 
interact with the radio waves. 
They resonate in this cavity at 7 
just the right frequency. 


At the lower part of the 

ground plane sit two ~ 
capacitors. These capture 

the radio signal. 
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The white text is added to the PCB using a silk-screen technique. 
These markings are used to provide information and branding for the board 


PI ZERO W 


You'll need the latest version of Raspbian with PIXEL 
from raspberrypi.org/downloads. Make sure you get 
the most recent update, as the latest version adds Pi 
Zero W support. Put your Pi Zero W inside its case. 
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Flash the microSD card and insert it into your Pi 

Zero W. Use a USB On-The-Go adaptor to connect 
your keyboard and mouse to the micro USB port 
marked ‘USB’ (chain the mouse via a keyboard USB if 
possible). Use a mini HDMI to HDMI cable (or adapter) 
to connect the Pi Zero W to a monitor. 


Connect a power supply to the micro USB port 
marked ‘PWR’. The Pi Zero W will power up into 
Raspbian with PIXEL. Click on the wireless icon in the 
top-right of the screen to locate your local wireless 


network. Enter your wireless password to connect the 
Pi Zero W to the network. 


01. Pi Zero 
The Pi Zero W board fits snugly inside 
the case. Holes provide port access. 


02. Clips 

The Pi Zero clips into the case 
using four protruding clips. It snaps 
securely to the bottom of the case. 


03. Camera Module 

The Camera Module is attached to the 
inside of the camera case lid. Like the Pi 
Zero W board, it snaps into place with the 
four plastic protrusions. 


04. Camera Cable 

The Pi Zero W case comes with a Pi Zero W 
camera cable. With this, you connect the 
Camera Module to the Pi Zero W board. 


05. GPIO header 

The case lids are interchangeable, and one 
lid enables direct access to the GPIO pins 
on the Pi Zero W. 
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The safe cover clips on to the The GPIO cover has a cut-out section We think the camera cover is the 
Raspberry Pi case, completely that enables you to access the star attraction. It holds the Camera 
sealing up the Raspberry Pi. GPIO pins without removing the lid. Module in place and resembles 
Perfectly shaped holes on the side Another cut-out in the base allows a digital camera. We can't wait to 
of the case enable you to access the room for solder and pin edges (on see what Pi Zero W projects the 
USB and HDMI ports. It makes for the the reverse of the board), but could community makes with integrated 
cutest computer around. be used for GPIO access too. wireless and camera functionality. 
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PI ZERO W 
PROJECTS 


Five great project ideas for you to build with your new Pi Zero W 


AMAZON gs 


mazon Alexa is an 
intelligent assistant 
making a lot of waves in 


Add a speaker to your Pi Zero W 


the tech community. Amazon sells using a Speaker pHAT 
two Alexa products: the Amazon 
Echo and Echo Dot. portable Amazon Alexa device. All USB microphone using the USB to 
Amazon has also created a you need are some speakers and USB On-The-Go adapter. 
homebrew version of Alexa for a USB microphone. Previously, you also had to 
the Raspberry Pi. Pimoroni’s Speaker pHAT add a button to the Raspberry 
Now that the Pi Zero W has (£12, magpi.cc/2kXdZsE) is a Pi version of Alexa, but a recent 
wireless LAN, it’s a perfect neat solution. Combine it witha update has added an ‘always on’ 


mode to the Raspberry Pi build. 
Alexa now listens for a vocal 
cue, such as the word ‘Alexa’ 
and then starts monitoring. 
You can change the vocal signal 
to any name of your choosing; 
‘computer’ is a popular choice 
for Star Trek fans. 

A GitHub repository has all the 
information you need to set up 
Amazon Alexa on a Raspberry 
Pi (magpi.cc/2kXrdW2). 

There is a complete guide here 
(magpi.cc/2kXfPcO). Frederick 
Vandenbosch has written a guide 
to installing Alexa on a Raspberry 
Pi Zero (magpi.cc/2kXkY4A). 
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Use a speaker and 
microphone to turn your Pi 
Zero W into a hands-free 
Amazon Alexa Echo 
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WEARABLE 
CAMERA 


The Pi Zero W case with camera 


lid lends itself perfectly to 
making a mini camera. You could 
add a button to the case using 
Sugru to build a digicam, or use a 
Bluetooth camera button (as found 
on selfie sticks). 

We also like the idea of making 
a wearable camera. Adafruit has a 
great tutorial on creating this project. 
Adafruit used a unique 3D-printed 
case, but now you can simply use the Pi 
Zero W case (magpi.cc/2kXASMw). 


The low power draw of the Pi Zero 
W also makes it ideal for use asa 
security camera, or as an outdoor 
wildlife camera. Hook it up to a 
Zero LiPo (magpi.cc/2kxI8YW) 
and you'll get a steady stream of 
power. Connect the Pi Zero camera 
and use the wireless LAN to send 
alerts when it detects motion. 
Take a look at Mark West's project 
(magpi.cc/2kXznhq). 


The low power draw of the 

Pi Zero W and its wireless (J 
connectivity make it ideal for 

use as a connected node. Add 

some storage and turn it into 

always-on network storage. 

This has always been a great 

Raspberry Pi project, but it is 

especially easy with the Zero W's 

built-in wireless connectivity. oe 


SMART CAR DASH 


The Pi Zero W is easy to mount on a car dashboard using a Zero View 
mount (magpi.cc/2kXIsaz2). You can use it as a dash cam to record 
footage. With the wireless LAN, you can connect to a personal hotspot 
(from your mobile phone). Consider checking out the open-source 
Dride project for software (magpi.cc/2lnBwjt). 
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An award- 


winning 
free and 


open-source 


software 


media centre 


Team Kodi 


OSMC 

OSMC runsa 
Kodi back end, 
but it uses its 
own interface 
and some other 
optimisations 
that the 

makers believe 
work better. 


Movies 


TV shows 


Music 


Music videos 


TV 


Radio 


Add-ons 


Pictures 
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new Kodi release is 

always cause for a little 

celebration. It’s one 
of the most successful, long- 
running pieces of open-source 
media software of any type, 
and it powers so many other 
popular media centres. The latest 
release of Kodi has some minor 
improvements behind the scenes, 
with an overhauled video playback 
engine which should benefit these 
other media centres in the long 
run. However, one of the biggest 
things that users of stock Kodi 
will notice is that there’s a new 
default skin that replaces the 
venerable Confluence. 
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17.0 
KRYPTON 


The premier HTPC software gets an update with a new look 
and some new tech behind the scenes 


Bare-bones 

Skins and interfaces can be changed, 
though, so before we delve into that 
let’s talk about the video playback, 
as it has had an update. 

Long story short, it’s pretty much 
the same. Additions to the new 
video player software include video 
stream selection (the different 
angles button on your old DVD 
remote) and the ability to better 
hand off video playback tasks to 
add-ons. This isn’t something 
you’ re going to notice day-to-day, 
but the real achievement is that the 
previous system was completely 
replaced with the new one without 
collapsing Kodi in the process: it 


being pretty much 
they did their job. 


the same means 
t’s a good thing. 


One thing we did notice was that 


the video output fr 


om the HDMI 


worked a little better with the HDMI 


switcher in our set 


up: in earlier 


versions, audio from a Pi using 


Kodi would someti 


mes hiccup as if 


the audio stream itself just wasn’t 
making it to the TV. We didn’t 
come across this issue with Kodi 17. 
There’s still a little trouble playing 
video encoded with 10-bit colour, 
though, with no improvements 
over the previous release. That’s 
more of an issue with a lack of 
hardware decoding for 10-bit on 
the Pi than with Kodi. 
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Categorie 


Music videos 


TV 


Radio 


Add-ons 


Pictures 


Videos 


Favourites 


Weather 


4 


Uitzending 
Gemist 


zendinggemist (NPO 


veakers 


Program add-ons 


© 


YouTube 


Dumpert 


We also noticed that, while still 
supposedly supported, AirPlay was 
working worse than ever. Before, 

n Apple device could at least see 

he Kodi box although we’ve never 
ctually seen AirPlay working 
etween the two. Now, it simply 
oesn’t show up. It would be good if 
he Kodi guys could get that working 
consistently, but it’s a minor issue. 


+saca aw 


said, you can’t change the order 
in which they’re listed and, for 
a device you’re probably mostly 
using to play back video, having 
the pure video option last in the 
list is not very useful. 

It runs beautifully on the 
Raspberry Pi, though, with smooth 
transitions between menus and the 
same basic structure as other skins. 


It runs beautifully on the 
Raspberry Pi, with smooth 
transitions between menus 


New look 

That brings us to the new interface, 
Estuary. It’s almost completely 
different to the old Confluence, 
with a greater focus on using 

the scraped metadata from your 
content and optimising the space 
to display said content. Inspiration 
has definitely been taken from 
modern smartphone UI and UX 
design, which makes sense as 

the way we use technology has 
changed over the years. You can 
still have your basic file selection 
if you prefer, though, and you 
actually get more control over 
which categories are listed on 

the home interface. That being 
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The settings menu is generally 
more useful and easier to navigate 
as well, although it does mean some 
extra add-on settings now live away 
from the settings menu in an all- 
encompassing add-ons field. 


Future-proof 

This new version of Kodi seems 
like a glimpse of what’s to come. 
With a more robust back end anda 
new front end to go with it, we’re 
probably going to start seeing a 
few more noticeable changes in 
the next version of Kodi. The new 
interface is great and a welcome 
change over the old Confluence one 
(although you can still install it if 


Kung Fury 


you prefer). Importantly, it still runs 
really well on a Raspberry Pi. We did 
most of our testing on a Raspberry 
Pi 2, which is more than likely the 
backbone for any home theatre 
setup, and it worked as well as ever, 
so there’s no worries there. 

It’s definitely a worthwhile 
upgrade over previous versions, 
so if you’re a LibreELEC user 
you should be on the lookout for 
version 8 when that comes out. 
Other HTPC OSes may be a little 
slower to integrate the new stuff, 
so you shouldn’t have to worry 
about it just yet. 


Add-ons 
can now also 
be found ina 
dedicated add- 
on category, 
though some 
will still show up 
in the relevant 
media categories 


The new 
interface is arranged 
much better than 
before, and even 
has symbols to 
signify if you have 
watched or are 
part-way through 
avideo 


A good upgrade to an already great piece of 
software. It still works just fine on the Raspberry 
Pi, so there's no need to overhaul your home 


theatre for it either. 


kek 
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Maker 
says 
Want 
to lose 
the Xmas 
dinner? 


Join Pi Metre , 


Pi Metre 


MY 
FITNESS 
PAL 


While 
MyFitnessPal 

is great, it 
doesn't run on 
the Raspberry 
Pi. The app is 
available for iOS 
and Android. 


FREE 
myfitnesspal.com 


PI METRE 


This is your 
PiMetre Gym: 


|— Click enter to close the locker fi 


To view your 
personal locker 
click 'L' 


ZB 


P| METRE 


A Scratch-powered fitness app for the Raspberry Pi. 
How does it help you get fit? 


he Pi Metre is a simple 
fitness app created for 
Raspberry Pi in Scratch. It 
was designed completely on Scratch 
2.0, So it’s only recently been able 
to work widely on Raspberry Pis 
thanks to the addition of Flash to 
Chromium. Luke Castle, the creator 
of Pi Metre, suggests also making a 
portable Pi setup to take it with you 
to the gym or while running, but it 
would work just as well at home. 

Pi Metre works by asking you to 
first start a workout. You do this by 
pressing E and entering the number 
of seconds you plan to work out; 
this does slow down the process 
a bit, as you need to transfer the 
minutes you plan to work out into 
seconds. The app will then count 
down the seconds and play an 
appropriate workout mix for you 
to exercise to. It lasts just over five 
minutes before looping again, so 
for longer workouts it may get a bit 
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repetitive. Once the countdown is 
done, it triggers an alarm to let you 
know your workout is over. 


runs on Scratch, it will use up 
a lot of resources. It’s quite fun, 
though, and a nice little project 


You can create a portable Pi 
setup to take it with you to the 
gym or while running 


Workout times are then kept in 
your locker, which can be accessed 
with L. Unfortunately, there’s 
no way to differentiate between 
different types of workouts, and it 
won’t calculate a calorie count for 
cardio. You get an account for the 
app as well, with the idea that you 
can save your workouts to refer 
back to them; you’ll need to make 
sure to log off, though, to save the 
workouts properly. 

It’s avery simplistic app 
and could do with a fair few 
extra components. Also, as it 


to make so you can create your 
own portable workout countdown 
and tracker. 


{ast word 


Avery simple workout app 
which is much better as a 
full Pi project than just the 


software on its own. You're 
probably better off witha 
smartphone app, though. 
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SPEAK 


ER PHAT 


Maker 
says 
Turn 
your Pi into 
G Lilliputian 
ghetto 


blaster 
Pimoroni 


SPEAKER PHAT 


MINI 
PORTABLE 
SPEAKER 


Powered or 
charged via USB 
and connecting 
to the audio 

out port of a 
standard Pi (but 
not Zero), this 
mini speaker 
packs a punch. 


£12 /$15 
magpi.cc/2diQyHq 
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imoroni’s latest pHAT may 

not sound all that phat, 

but it does offer a neat 
way to quickly add audio to your 
projects. This Pi Zero-sized board 
manages to cram in a mini speaker, 
PS DAC, and mono amplifier. We 
particularly appreciate the 1980s 
boombox-style artwork on the 
top of the board, complete witha 
ten-LED bar graph. 

Since the 8Q, speaker has just 

2W of power, you won’t exactly 
be rocking the neighbourhood. It 
sounds more like a tinny transistor 
radio than a ghetto blaster, 
offering little in the way of bass 
and obviously no stereo), so it’s 
certainly no rival for high-quality 
audio add-ons from the likes of 
QaudlO and JustBoom. But then 
that’s not what it’s intended for; 
instead, it should prove suitable for 
projects that require audio output 
for notification sounds or speech. 
ndeed, it would be ideal for the 
digital whoopee cushion in this 
issue, precluding the need to wire 


A tiny speaker board for adding sound to projects 


up a separate powered speaker. 
Other use cases include a retro 
gaming handheld or — by pairing 
it with a mini microphone — a DIY 


command. It should then work as 
the default audio output, although 
you may need to reboot the Pi first. 
We tested it out with aplay and 


It is nevertheless a great way 
of adding audio to projects 


voice assistant based on Amazon 
Alex or the like. 

The Speaker pHAT comes in kit 
form, requiring about 30 minutes to 
assemble. First, you need to screw 
the speaker to the rear of the board, 
using tiny spacer nuts, which is a 
little fiddly. Then it’s time to get 
the soldering iron out. Soldering 
the speaker’s two terminals to the 
board contacts with the supplied 
24AWG wire is a bit awkward and 
you need to use tweezers to hold 
the bare wire as it gets hot! It’s 
then simply a matter of soldering 
on the 40-pin female header and 
the pHAT is ready to use. 

Installation of the software is 
achieved with a single terminal 


mplayer from the command line, 
as well as Sonic Piand YouTube 

in the Chromium web browser. 
There’s also a library for manually 
controlling the LEDs if you want. 


{ast word 


Not one for audiophiles, 
the Speaker pHAT offers 
rudimentary sound quality 
with little power. It is 
nevertheless a great way of 


adding audio to projects, with 
its tiny Zero-size footprint and 
no need for a separate power 
supply. It looks cute too. 
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Right The Cluster HAT sits on top 
of a Raspberry Pi 2/3 board 


Maker 
Says 


Ideal tool 
for teaching, 
testing or 
simulating 
small-scale 


clusters 
pimoroni 


PICO 5 
STARTER 
KIT 


PicoCluster 

has a range of 
cluster kits for a 
range of boards 
(including the 
Raspberry 

Pi). They use 
Ethernet 
networking 

and Raspberry 
Pi 2/3 boards, 
but are more 
expensive. 


£189 / $239 
magpi.cc/2kAcJLG 


CLUSTER HAT 


5 ssstsseuae/, 


Make a cluster computer with a Raspberry Pi and four Pi Zeros 


uilding a computer 
cluster is one of the most 
impressive Raspberry 
Pi projects. And being able to 
program cluster computers is one 
of the most highly valued skills in 
the world of big data. 

A cluster is a set of computers 
networked together and used as 
a single system. Each computer 
(or ‘node’) is scheduled to work 
on the same task, controlled bya 
master computer. 

Knowing how to manage, 
and use, clustered computers 
and supercomputers is a pretty 
valuable skill. It’s also one of the 
areas at the absolute forefront of 
computing technology. 

But it has always been difficult 
to get started. Traditionally, cluster 
computing has been an expensive 
hobby. You need lots of computers 
(preferably identical) anda 
network controller and the skill to 
network them all together. This 
difficulty is before you even start 
learning how to manage several 
computers working in tandem. 
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On top of all that, it can be 
expensive to run multiple full- 
sized computers. Energy costs 
quickly ramp up when you're 
running a cluster. 


Hat on it 

The Cluster HAT removes the 
expense and effort required 

to create a cluster. This lower 
barrier to entry makes it a lot 
easier to get on with the more 
important act of learning cluster 
computing technologies. 

The HAT sits on top of 
a Raspberry Pi 2/3 and you slot four 
Pi Zero computers on to the HAT 
(via the USB connection). 

A USB cable is run from the 
Raspberry Pi to the HAT to provide 
power to the four Pi Zero boards. 
The latter are controlled directly 
via the GPIO pins. 

You need a microSD card for each 
Pi Zero, and one for the controlling 
Raspberry Pi. So that’s five SD 
cards in total. 

We costed up a Raspberry Pi, 
Cluster HAT, four Pi Zero boards, 


and four official microSD cards 

— it comes to £102. That’s by far 
the cheapest cluster computer 

you will find on the market. For 
those looking to get into cluster 
computing, this is a game-changer. 


Getting started 
Setting up the Cluster HAT 
hardware was an absolute 
breeze. Screw the four pins on 
to a Raspberry Pi 3 board and 
insert the supplied USB cable, 
then attach the HAT (wiring the 
cable between the board and HAT). 
Attach the USB power to the HAT 
and then slot on the four Pi Zero 
boards. The whole setup took less 
than five minutes. 
Software is well handled too. A 
dedicated site (magpi.cc/2jHMeQq) 
provides image files for the 
controller (the Pi 2/3) and one 
image file for each Pi Zero board. 
The Cluster HAT version 
of Raspbian boots into the 
command line, but offers a 
script for controlling the cluster. 
For example: 
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clusterhat on all 


This command-line code 
switches on all four Pi Zero 
boards. You can also control them 
separately, using p1-4. Such as: 


clusterhat p2 off 
clusterhat p2 on 


It takes a few moments for 
each Pi Zero to power up and load 
its software, at which point it'll 
appear in ifconfig. 

Access each node using SSH 
(enabled by default): 


ssh pi@p1.local 


Here you can use ifconfig to 
find the IP address Cluster HAT 
has assigned to the Pi Zero 
(under USB Ethernet). 


Pi computing 
One thing this isn’t, though, is a 
supercomputer. There’s a good set 
of benchmarks by Nick Smith on 
Climbers.net (magpi.cc/2jKlq23). 
Nick used iperf to test the 
network-over-USB connection and 
found it comparable to Ethernet. 
The slower speed of the Pi Zero 
boards compared to Raspberry Pi 2/3 
boards is much more pronounced. 
Nick benchmarked the system 
using HPC Challenge Benchmark 
(magpi.cc/2jKpH5C). He found 
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the cluster of four Pi Zero boards 
ran at roughly half the speed of 
a single Raspberry Pi 3 board. 

The slower speed makes sense 
when you think about it. Nick 
explains: “This is partly down 
to the faster individual cores in 
the Pi 3, but also the node-node 
communication is obviously 
a great deal faster within the Pi3 
SoC compared to communicating 
between separate Zeros with 
Ethernet-over-USB.” 

So you’re not building a faster 
Raspberry Pi. However, we 
don’t think this matters. The 
aim for most people will be to 
build a low-cost and relatively 
easy-to-assemble cluster for 
educational purposes. 

Once created, you can start to 
experiment with the concepts 
behind cluster computing. The 
Cluster HAT is ideal for teaching, 
learning or developing cluster 
computing ideas. 

We suspect it will also appeal to 
developers who have access to larger 
cluster computing systems, but 
not all the time. You can test and 
run code on the Cluster HAT, then 
migrate it across to a larger system. 


Distributed computing 
Cluster computing is not a game 
for beginners. Realistically 
speaking, prospective learners 
will need a working knowledge of 


CLUSTER HAT 


Python, Java, SQL (and relational Above Left The 
: 3 USB sockets on 
database techniques). You’ll also the Cluster HAT 
need a good understanding of provide connection 
for four Pi 


the Linux command line. 
Fortunately, starters are 
not alone. There’s a vibrant 
Cluster HAT Google Groups board 
(magpi.cc/2jHYqk6). There are 
lots of resources and projects 
being shared by the community. 
One book that is recommended 
reading is Raspberry Pi Super 
Cluster (£16.78) by Andrew K 
Dennis (magpi.cc/2jHZyV8). 
Whatever resources you choose, 
we think the Cluster HAT is a great 
resource for starting distributed 
computing. It’s small, cheap, and 
easy to set up. 
You have to leap a lot of hurdles 
to learn cluster computing. 
But Cluster HAT removes 
the expensive and difficult 
hardware build. It’s then up to 
you to learn the sophisticated 
coding techniques. 


Zero boards 


Above Right The 
Raspberry Pi 3 
board is the only 
device using 
Ethernet. Network- 
over-USB is used 
to hook up the Pi 
Zero boards 


{ast word 


Acompact, neat and cost- 
effective solution to building 

a cluster computer. The end- 
product might lack raw power, 


but it’s perfect for teaching 
and Learning distributed 
computing concepts. 
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BOOKS 


TECHNICAL 
BESTSELLERS 


Dr James Stone's Tutorial books for 
Sebtel make technical, mathematical 
subjects easily understandable. 


BAYES’ RULE: 


A TUTORIAL INTRODUCTION 
TO BAYESIAN ANALYSIS 


Author: Dr James Stone 
Publisher: Sebtel Press 
Price: £14.95 

ISBN: 978-0956372840 

magpi.cc/2lFLqx5 


The revival in interest in Bayes’ 
theorem - studying probability 
based on information we have 
- has found a use in many 
fields. This is possibly the best 
general introduction to the field. 
Recommended. 


INFORMATION 
THEORY: 


A TUTORIAL INTRODUCTION 


Author: Dr James Stone 
Publisher: Sebtel Press 
Price: £16.95 

ISBN: 978-0956372857 

magpi.cc/2LFOWwRp 


An outstanding introduction 
that can pullin the general 
reader with dry humour, but 
has the textbook rigour needed 
by programmers looking for 

a fuller understanding of this 
essential subject. 


BAYES’ RULE 
WITH PYTHON 


Author: Dr James Stone 
Publisher: Sebtel Press 
Price: £19.95 

ISBN: 978-0993367939 

magpi.cc/2lFLqx5 


The Bayes book, with inline 
Python code examples of the 
probability problems. Also 
available in R and Matlab 
flavours. Very handy for helping 
to work through tougher 
examples in Jupyter Notebook. 
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PYTHON, PYGAME 
AND RASPBERRY PI 


GAME 


DEVELOPMENT 


Author: Sloan Kelly 
Publisher: Apress 
Price: £14.99 

ISBN: 978-1484225165 
magpi.cc/2lFOdGy 


Writing games 
remains one of 
the best ways to 
motivate learners 
through some of the challenges 
of learning to code. The Pygame 
library provides enough abstraction 
to let the reader produce working 
games relatively easily, without 
hiding away anything of real 
educational value. Marketed at 
Pi users, Kelly’s fine tutorial can 
be used on any computer where 
Pygame is installable. 

Hello World is preceded by 
a useful introduction to data types 


THE BIG BOOK OF 
MAKERSPACE 


PROJECTS 


Authors: Colleen Graves, 


Aaron Graves The Big 


Publisher: McGraw Hill "7 y= ym 
Price: £15.99 17 A K En 


ISBN: 978-1259644252 
magpi.cc/2lLFLINM 


Learning programming 
has well-established 
routes, such as Hello World, 
loops, and variables, but what’s the 
beginner maker to do? The Graves’ 
excellent collection of projects will 
build up your skills, then challenge 
you to go further. Hello World 
here is the Brushbot Warrior, 
repurposing everyday equipment, 
then proceeds via Scribble Bots to 
a host of other moving projects. 
After circuits, coding, and 
smartphone projects (DIY 
projector), we’re back to non-tech 
skills, with some great musical 


ers 80 Exper 


and programming styles - who 
knew pencils were object-oriented? 
~ then followed by programming 
basics, all with reference to parts 
of typical games. The writing style 
and short chapters give a pleasing 
forward momentum, and we’re soon 
at our first game. 
After due recognition to design 
and testing, there’s Bricks, a 
classic Breakout-style game, 
always a good teaching example, 
with movement and collision. 
Building on this example, object- 
oriented programming is explored 
fully; there’s a lot here, but some 
of it gets reinforced in the next 
game, Snake. MVC is introduced 
for Robots. Final chapters cover 
sound and finite-state machines, 
wrapping them up with a game of 
Invaders. Not always easy going, 
but this well-paced introduction 
to programming will rapidly carry 
newbies a surprisingly long way. 


Score 


instrument builds. After sewing 

circuits, more electronics; the 

supply listings are localised to US 
suppliers, but it shouldn’t take too 
much effort to track things down 

wherever you are, locally 

as well as through the 

internet. Projects are 
followed by challenges, 
suggesting you step beyond 
following instructions and 
cts ggg Make projects your own. 

! Every maker needs some 
of these projects in her 
armoury, ready to build with 

the next person who asks “what’s 

it all about, then®”. If you’re new to 
making, there are plenty of cheap 
and easy projects to build skills and 
confidence. Many of these will be 
great to run on makerspace open 
days. And if you’re an old hand, the 
challenges and harder projects are 
well worth trying out. 


rere, 


Book of 


Score 
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APACHE SPARK 
IN 24 HOURS 


Author: Jeffrey Aven 
Publisher: SAMS 
Price: £27.99 

ISBN: 978-0672338519 | SamsToach Yoursett 
magpi.cc/2lFUBot 


| Spark 


Apache Spark is 
an essential tool 
for tackling big 
data, providing 
an API for data 
processing in Scala, Java, R, or 
Python. Aven’s book focuses 

on Python and, beyond a basic 
comfort in that language, assumes 
no particular knowledge on the 
part of the reader. It introduces 
everything from Scala to Hadoop 
before tackling a range of Spark 
topics with Python examples. 

The tools of the trade for big data 
and Spark are introduced one by 
one, from Hadoop and MapReduce, 
through Resilient Distributed 
Datasets (RDD) and cloud 


A BEAUTIFUL 
ANARCHY 


Author: David DuChemin 
Publisher: Rocky Nook 
Price: £14.99 

ISBN: 978-1681982342 
magpi.cc/2lFTBtg 


A very personal 
manifesto, written 
for anyone witha 
calling to make, 
whether it’s a 
painting or a great business. 
“We're all creative,” says the 
author, “but we’ve allowed art 

to co-opt the word.” Many take 
default choices rather than the 
difficult path of trying to write 
that novel they know they have 
in them, or set up that business. 
This is a call “to step out of the 
comfort zone, and face the fear.” 
Praising bad ideas, constraints, 
and the art of exclusion, 
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| Apache 


computing, to machine learning 

and message queues. RDDs are 

in-memory data structures which 

are part of Spark’s speed and 
efficiency; the Spark Core 
API is the other key to 
Spark’s success, respecting 
a strongly functional style 
of programming. 

R, SparkR with RStudio, 
and Scala get chapters, and 
it’s great to see functional 
programming in Python 
getting treated as well as 

in Scala; however, that 
chapter also squeezes in 
IPython and Jupyter Notebooks, 
showing the limitation of the 
24 hour-style chapters. Final 
chapters on administering, 
extending, monitoring, securing, 
and improving the performance of 
Spark give the reader everything 
she needs to go further — a solid 
foundation for Spark with Python. 


Score 


DuChemin returns to the same 
theme from a different angle: 
you have a creative urge inside 
you, so stop making excuses, 
and start facing up to the 
difficult journey to writing 
that novel, starting that 
business, or painting that 
picture: “Living a great 
story is much harder than 
watching a great story.” 
This is a book about 
choices; those we make or 
those we abdicate all have 
an effect on our creations. 
It gets the reader to ask 
themselves questions about 
what they want in life. What 
dreams do you still hold onto? 
This call to colour outside 
the lines, and DuChemin’s 
questioning, have a way of getting 
under your skin and making you 
ask those difficult questions. 


Score 


BOOKS 


ESSENTIAL READING: 


R FOR STATS 


While Python nips at R's heels, R remains great 
for statistics and many general data tasks. 


The Book of R 


Author: Tilman M Davies 
Publisher: No Starch 
Price: £39.99 

ISBN: 978-1593276515 
magpi.cc/2lGoYkf 


THE — OF 


Combines a programming tutorial with 
an introduction to statistical methods, 
succeeding well at both tasks. Strongly 
recommended for newbies. 


A Course in Statistics with R 


Authors: Prabhanjan N Tattar, 
Suresh Ramaiah, 
B G Manjunath 
Publisher: Wiley 
Price: £70.00 
ISBN: 978-1119152729 
magpi.cc/2LFV5Uj 


Despite occasionally idiosyncratic 
English, this is a wonderful deep dive into 
statistics strongly integrated with R code. 


Efficient R Programming —— 


Authors: Colin Gillespie, Robin Lovelace 
Publisher: O'Reilly 

Price: £28.50 

ISBN: 978-1491950784 
magpi.cc/2lFOUZE 


am Aa 


fn 


Efficient R 
Pr gramming 


Essential next step in learning R - 


efficiency in programmer (your) time, and ae | 
eliminating bottlenecks through deeper : 
language understanding. 


Statistical Shape Analysis: 
With Applications in R 


Authors: lan L Dryden, Kanti V Mardia 
Publisher: Wiley 

Price: £65.00 

ISBN: 978-0470699621 
magpi.cc/2LFK1GK 


Statistical methods applied to shape 
analysis. Great for biologists, but strong 
mathematical treatment and accompanying 
code expands possible applications. 


Categorical Data Analysis 
by Example 

Author: Graham J G Upton 

Publisher: Wiley 

Price: £80.50 

ISBN: 978-1119307860 
magpi.cc/2lG6930 


TEGORICAL 
BATA ANALYSIS 
BY EXAMPLE 


Concise introduction to dealing with 
categorical data (with supporting R code) 
which will help the general data scientist. 
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FEATURE 


Community 


FOSDEM 


EUROPE'S INCREDIBLY BIG FREE 
SOFTWARE DEVELOPERS’ MEETUP 


In medieval times, 10,000 was the population of a major city. For one weekend each 
February, it’s the number of free software developers attending FOSDEM in Brussels 


en thousand attendees is 
a guesstimate, as FOSDEM 
is an entirely free event 


with no registration. It’s certainly 
very big! Now in its 18th year, 
FOSDEM has been referred to as ‘a 
week-long event happening over 
a weekend’. Indeed, it feels very 
concentrated, with dozens of talks 
happening at once (610 speakers 
in total), almost all rooms full to 
capacity, and busy project stands 
spread over several buildings. 

The conference runs on 
goodwill, volunteer energy, and 
a modest amount of discreet 
sponsorship (plus coffee and 
Belgian beer). While all talks are 


OPENING 
THE LEDGER 


Free software developers don't just pick the 
fun stuff - Software Freedom Conservancy 
was discussing its work on new ledger- 
based accounting software for not-for-profit 
organisations, something the third sector has 
been demanding for many years. 

And on a global scale, Evan Schwartz was 
talking about tackling the mess of incompatible 
digital payment systems with W3C’s InterLedger 
project, an inter-networking protocol for money, 
with many parallels to the way the internet 
itself works. 

The slides and white paper are available here: 
magpi.cc/2lovKHy 
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in English, and many Americans 
fly in to attend or speak, the 
corridors buzz with geeky chat 

in Flemish and French, and 
Scandinavian and Slavic languages 
abound. This is Europe’s developer 
meetup; it exists because it’s 
important for free and open source 
software developers to be able to 
meet in real life. 

With 55 tracks over 30 rooms of 
the Université Libre de Bruxelles, 
you’ ll find not just your favourite 
projects, but many new discoveries. 
This year’s event included languages 
from GNU Guile to Python, 
technologies from containers to 
microkernels, and hardware projects 
covering everything from the 
embedded space to chip designers. 
Add in documentation, design, 
and community management, 
and FOSDEM has the entire free 
software and open hardware 
ecosystem present. 


Introductory music 
There’s no room on these pages 
to even list the 600+ talks, so 
here’s a tiny flavour of all that 
was on offer. Let’s start with 

the arts. Music in particular is 
often well-represented at techie 
events, and one outstanding free 
software project is MuseScore, 
which makes it easy to produce 
great-looking sheet music that can 
also be played back through the 
project’s soft synthesizer. 


The project featured in the 
design track, as its usability 
research was profiled. It was also 
featured in a talk on OpenScore, 
which is crowdsourcing MuseScore 
digitisation of out-of-copyright 
sheet music to build a vast library 
of semantic score data, open for 
analysis with tools like MIT’s 
music21, as well as freely accessible 
sheet music. Partners for OpenScore 
include the IMSLP public domain 
sheet music library: imslp.org. 

Good as it was to see some old- 
school analogue synths in the slides 
of Python developer Yann Gravrand, 
it was even better to hear a live 
demo of them being controlled via 
Python by his old MIDI drum pads, 
and the mido and portmidi libraries. 

More exotic languages were 
used by Belgian digital artist 
Francois Zajéga in the Open 
Game Development devroom. He 
demonstrated sounds from the 
Pure Data language, with Ogre3D 
visuals on the Polymorph video 
game platform, suitably impressive 
visuals and music, dancers, and 
artists. His presentation is available 
here: magpi.cc/2louvlf. 

There were more visual arts from 
swarms of lightweight (27 grams — 
less than an ounce!) Crazyflie 2.0 
drones, painting, climbing, and 
commanded by a MIDI glove. Drones 
were also flying over the attendees 
in the GoLang rooms, where 
systems programming included IoT. 
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Thanks to FPGAs, says Philipp 
Wagner, we can replace slow 
waterfall design processes with 
agile methods and rapid iteration 


Pi’s subtle presence 
The Raspberry Pi is very well 
established to the point that it’s 
not much talked about. However, 
it was quietly working on many 
displays, such as Automotive 
Grade Linux (running on Yocto and 
OpenEmbedded), in ports of much of 
the software from the Kolab images 
to experimental builds of Haiku 
and Illumos, and in NextCloud’s 
Pi 3-based Dropbox replacement. 
Ben Nuttall was there to fly the 
flag for the Raspberry Pi Foundation, 
and talk about HATs. If you’re 
interested in building your own HAT, 
with entirely free and open-source 
tools including the board design, 
watch the video of Leon Anavi’s talk. 
And look out for a feature on Anavi’s 
HAT in these pages soon. 
Python got its own full day of 
lectures: everything from how 
data structures are implemented 
in CPython, to Python in the 
cloud. Roberto Colistete Jr talked 
about ‘Scientific MicroPython for 
Microcontrollers and IoT’. BoF 
sessions were held outside the 
lecture room, and posters revealed 
how much internet giants like 
Facebook use Python. It’s a sort of 
mini PyCon, with bonus sidetracks. 
Etiene Dalcol spoke about making 
wearables with NodeMCU, a Lua- 
based language. Interesting ‘niche’ 
languages were well-represented, 
although the regular visit from 
Belgium’s Ada group is sadly a 
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thing of the past. Guile, the Scheme 
dialect used in many GNU projects 
and particularly in GUIX, featured 
many interesting sessions. Of these, 
MagPi readers may be interested in 
‘Natural Script Writing’, featuring a 
Guile dialect with whitespace, which 
“makes the transition from Python 
to Lisp seem a lot less scary.” 


Sharing knowledge 
Documentation is a concern for 
anyone trying to get things done 
with a piece of software. Rich 
Bowen had some great advice for 
those responsible, stating that 
documentation — including IRC 
channels — sets the tone for your 
project. How welcoming are you to 
new users? If you find new users not 
sticking with your project, take a 
listen to his presentation. 

At the top end of the document- 
handling scale, XWiki was doing a 
sterling job of presenting itself as 
a useful alternative to Microsoft 
Sharepoint. The humble TikiWiki 
was also present as part of the 
WikiSuite tools, offering secure, 
self-hosted software for ‘data- 
driven’ organisations. 

Knowledge was on offer 
everywhere: a chance hallway 
meeting with Nikita Voloboev 
offered the chance to try large 
mind maps of scientific knowledge: 
magpi.cc/2l0QNcP. Sharing must 
be balanced with privacy, and pp 
(pretty Easy privacy) was pushing 


anaes Community 


FREE CHIPS 
(NOT FRITES) 


The dependency of free software on far from open 
hardware has been a nagging worry since the early 


days of the movement, and projects like LibreBoot 
are perennial FOSDEM visitors. This year’s event 
saw two highlights for those looking to run on 
entirely free and open hardware. 
Georg Greve, CEO of Kolab and former 
FSFE president, impressed the audience with 
the potential of OpenPOWER chips for high- 
performance computing and the data centre, while 
the less powerful but very adaptable OpenRISC V 
offered many custom and off-the-shelf possibilities. 
In addition to these, Olimex had brought its 
TERES-I DIY laptop from Bulgaria, complementing 
modularity and free software with free tooling 
through the design process, and open-source PCB 
CAD files on GitHub. 


easy cryptography for the masses. 
The crowded Decentralised Internet 
devroom also offered a roadmap 
for the next few years’ defence 
of privacy. 

Daniel Stenberg, the creator 
of the ubiquitous tool curl, gave 
a talk named ‘You know what’s 
cool? Running on billions of 
devices’, about the unexpected 
demands of maintaining code that 
everybody’s using. There were talks 
on legal issues and community 
development, lightning talks, 
considered keynotes, file formats 
in open media, and data formats 
in many languages. Some of the 
most interesting talks were in the 
Software Defined Radio devroom. 

FOSDEM has evolved over the 
years, gradually embracing some 
elements of the upstart maker 
community, as well as embedded 
development (particularly 
Automotive Grade Linux), and 
even chip design. By far, the best 
of FOSDEM remains the corridor 
conversations, which are a great 
opportunity to meet programmers 
and other free software advocates of 
all backgrounds. But if you missed 
it, you don’t have to wait for next 
year — take a look at the magnificent 
archive of technical talks at 
fosdem.org/2017. 
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THE MONTH IN 


Everything else that happened this month in the world of Raspberry Pi 


84 


e launched a sister magazine 

last month called Hello World, a 

free computing magazine aimed 
specifically at educators. The reactions 
to it have been fantastic, with attendees 
of the Bett Show and other educators 
around the UK (and indeed the world) 
excited to get their hands ona copy. 
You can find out more info on how to 
get one yourself at helloworld.cc, and 
help kids and teens learn more about 
computing everywhere. 


BASED ON THE UNTOLD TRUE STORY 


‘ai MEET THE WOMEN YOU 


BEHIND THE MISSION YO 
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ia | Gemma Sanderson —— 


Should be preparing for #t jus but look 
what's arrived @ Id_Edu 


©) Mr Acam Rooney 2 folew 
ae 

Some good magazines here to come up with 
some exciting new classes for next term & 
@HelloWorld_ Edu @tes @ocr_ict 


NX 


¢ , Richard Smith & Fenn 
eds 
Used the great helloworld magazine with a 
small group of students. Wonderful ideas. Free 
for educators @mbe DHelloWorld_Edu 


@CompaAtS 


Fo Cloghans Hill NS > Fetiew 


Thank you so much we r thrilled 
with our special delivery of 
it's amazing > 
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THIS MONTH IN Pl 


CROWDFUND THIS! 


The best crowdfunding hits this month for you to check out... 


RUMEREEEEEE Liaiaiaal Pineno a 


MEARM PI ELBESQ HAT 


If you cast your minds back a little while, you may | kckst/alebwts | 


remember that we reviewed the excellent MeArm robot 


arm — it’s pretty popular in the Pi community, even While not boasting a very descriptive name, the 
though you need to do some rejigging to get it working Pi186050 HAT allows you to plug in 18650 rechargeable 
with it. It’s no surprise, then, that the team behind it Li-ion batteries to power the Raspberry Pi. The 

are making a Pi-specific version, and have asked the HAT fits on older 26-pin Raspberry Pis as well, and 


community to help fund it, which they did in less than offers a new way of enabling portability for the Pi. 
12 hours. They’re currently at 300%, so it’s agreat time _ It’s smashed its funding target, so get on board now 
to jump on and get your own kit. to get one to boost your portable projects. 


BeoWOR HE RES Ie icearcn nnd 


magpi.cc/2kQJgjn magpi.cc/2kQp5NT 


G B A Pp | RUNMYROBOT GUEST WIFI 
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David joined 

us at the St James's 
Palace Community 
celebration, mingling 
with the likes of the 
Duke of York, plus 
organisers of Jams 
and clubs, such as 
Grace and Femi 


A Raspberry Pi maker and student, who plans 
to add as many letters as he can after his name 


avid’s experiences in 

computer education came 

slightly later in life. He 
admits to not being a grade-A 
student: he left school with few 
qualifications, unable to pursue 
further education at university. 
There was, however, a teacher 
who instilled in him a passion for 
computers and coding which would 
stick with him indefinitely. 

Twenty years later, back in 2012, 
David heard of the Raspberry Pi-a 
soon-to-be released “new little 
marvel” that he instantly fell 


for, head-first. Despite a lack of 
knowledge in Linux and Python 
he experimented and had fun. He 
found a Raspberry Jam and, with 
it, Pi enthusiasts like Mike Horne 
and Peter Onions. The projects on 
display at the Jam were enough 
to push David further into the 
Raspberry Pi rabbit hole and, after 
working his way through several 
Python books, he began to take 
steps into the world of formal 
higher education. 

With a MOOC qualification 
from Rice University under his 
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Self-playing xylophones, Wiimote air drums, Lego sorters, Pi Wars robots, 
and more. David is continually hacking toys, giving them new Pi-powered life 


belt, he continued to improve 
upon his self-taught knowledge 
and was fortunate enough to be 
accepted to study for a master’s 
degree in Computer Science at 
the University of Hertfordshire. 
With a distinction for his final 
dissertation, David completed 
the course with an overall 


His website, the pun-tastic Pi 
and Chips, is home to the majority 
of his work; David also links to 
YouTube videos and walk-throughs 
of his projects, and relates his 
experiences at various events. 

If you’ve followed any of the 
action across the Raspberry Pi 
social media channels — or indeed, 


Despite a lack of knowledge 
in Linux and Python, he 
experimented and had fun 


distinction for his MSc and was 
recently awarded a fully funded 
PhD studentship with the 
Knowledge Media Institute. 

The portfolio of projects 
that helped him to achieve his 
many educational successes has 
provided regular retweet material 
for the Raspberry Pi Twitter 
account, and various blog entries 
have been penned to highlight his 
fun, imaginative works. 

His builds have travelled to 
a range of Jams and made their 
way to the Raspberry Pi and Code 
Club stands at Bett, as well as 
to the birthday celebrations for 
the tiny microcomputer. 
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read any previous issues of The 
MagPi magazine — you’11 no doubt 
have seen a couple of David’s 
projects. The 4-Bot, a robotic 
second player for the family game 
Connect Four, allows people to go 
head to head with a Pi-powered 
robotic arm. And believe us when 
we Say that it’s not as easy to beat 
as you’d hope. Then there’s his 
more recent air drum kit, which 
uses an old toy found at a car boot 
sale, plus a Wiimote, to make a 
functional air drum displaying 
David’s toy-hacking abilities... 
and his complete lack of rhythm. 
He does fare much better on his 
home-made laser harp, though! 


David's determination to access and complete further 
education in computing has earned him a three-year PhD 


studentship. Not bad for a “Lousy student” 
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Code Club helps get kids coding around the world. Here’s how... 


f you haven’t yet heard 
about it, Code Club is 
a global network of 


volunteer-led extracurricular coding 
clubs for children. 

Code Club first started in the 
UK, back in 2012, to help children 
develop coding skills. Since then, 
this idea has spread around the 
world and there are now over 9,000 
Code Clubs internationally. 

In 2016, Code Club officially 
launched its international 
programme (Code Club 


HOW TO START A CODE CLUB 


Code Club is completely free and it's very easy to run 


your own. All you need is: 


> Avenue - this could be a local school, 


library or community centre. 


> Avolunteer - that's you! 


> Children to take part in the club. 
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International, magpi.cc/2lfaGNm). 
Code Club partners with local NGOs 
(not-for-profit organisations). 
These share the mission to have a 
Code Club in every community in 
the world, and support the country’s 
local Code Club community. 

Currently there are Code Club 
partners in ten countries. Code Club 
Australia, the biggest community 
outside the UK, has over 50,000 
children attending Code Clubs 
(magpi.cc/2lgjyiE). In fact, in 2016 
they set a world record for the 


most kids coding at a single event. 
“Coding is the language of the 21st 
century”, says Kelly Tagalan from 
Code Club Australia. “Our mission is 
to make sure every Australian child 
has the opportunity to learn how to 
code, no matter where they live or 
what school they go to.” 


Global volunteers 

Anyone can start an individual 
Code Club in their local community, 
anywhere in the world (see ‘How 

to Start a Code Club’ below). There 


Once you are ready to go, all you need to do is 
register on the Code Club International website and 
verify that your club is active. You'll get online access 


to a club account where you can find free resources 


to use in your club, such as posters, badges, and 
certificates. And you will be able to use the free 
curriculum of Scratch, HTML/CSS, and Python 


projects to teach in your Code Club. 
Visit Code Club World: magpi.cc/2kBa6JL. 
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are clubs all around the globe, 
in countries such as Mauritius, 
Bermuda, Nigeria, Kazakhstan, 
the Philippines, and Israel. 

Code Clubs come in all shapes and 
sizes and some of the most powerful 
Code Clubs make a big difference for 
avery small number of local kids. 

Max Dolgikh runs a Code Club 
in Ukraine. He’s been teaching 
students to use Scratch. One 
Ukrainian boy, Vova, wrote a version 
of the classic game Arkanoid. “I was 
happy all day long,” says Max. “It’s 
worth teaching to just a single child 
to give them a better life.” 

Volunteering at a Code Club is a 
good way for STEM graduates to pass 
on coding skills while developing 
communication skills. 

“T have the opportunity to 
share my knowledge with young 
people in my community,” 
says Shohel Rana, a Code Club 
volunteer in Bangladesh. “At the 
same time, these experiences 
taught me to communicate 
concepts to a group, skills that will 
serve me in the future.” 


CODE CLUB INTERNATIONAL 


Inspire kids to become the next 
generation of digital makers 


r,. ~S 


Volunteering is also a good thing 
to do. “I feel really happy when I am 
volunteering at Code Club because 
I feel a sense of real achievement,” 
says Mizanur Rahman, a Code 
Club volunteer in Bangladesh. 
“These children do not have big 
ambitions and they think of doing 
similar jobs as their poor parents,” 
explains Mizanur. “At Code Club, 
we provide a creative platform. 
They can express themselves with 
confidence and learn skills with 
better career prospects.” 

Code Club is looking for 
volunteers around the world. 
Anyone can start an individual Code 
Club in their local community. 

Start a Code Club in your local 
area and you’l get to inspire the 
next generation of digital makers. 
Visit Code Club International and 
don’t forget to register your club. 
Class projects are completely free, 
and available in 25 languages — from 
French and Spanish to Korean, 
Arabic, and Hebrew — for registered 
Code Clubs. Visit magpi.cc/2InuqLL 
to see how you can help. 


“a7 92 oa a 
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Code Club students in 
Ukraine are learning 
computer science skills 


Community 


CODE CLUB 


INTERNATIONAL 
IN NUMBERS 


OFFICIAL 
COUNTRIES 


9000+ 


CODE CLUBS 
WORLDWIDE 


100,000 


KIDS HAVE ATTENDED 


LANGUAGES 
ZORRO vse 


120+ 


COUNTRIES 
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EVENT CALENDAR 


Find out what community-organised, Raspberry Pi- 


themed events are happening near you... 


#PDATTHECOTTAGE 
RASPBERRY JAM 


Want a Raspberry Jam in your 
area? Want to start one? 
Email Ben Nuttall about it: 


ben@raspberrypi.org 


3RD ANNUAL HISAR 

CODING SUMMIT 

When: Friday 10 — Saturday 11 March 

Where: Hisar Okullari, Istanbul, 
Turkey 

magpi.cc/2ktyM3C 

Sharing and spreading essential 

knowledge of programming and 

algorithmic thinking. 


BLAYDON RASPBERRY JAM 

When: Saturday 11 March 

Where: Blaydon Library, 
Blaydon, UK 

magpi.cc/2ktAFwS 

The first Blaydon Jam. If you’re 

interested in Raspberry Pi 

computers, join in: mingle, 

learn, share, and enjoy. 
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#PDATTHECOTTAGE 

RASPBERRY JAM 

When: Saturday 25 March 

Where: 619 Elm Street, Minden, 
LA, USA 

magpi.cc/2ktjUIM 

The inaugural Louisiana Raspberry 

Jam: discover the world of 

Raspberry Pi and what it can do. 


DUNDEE 

RASPBERRY JAM 

When: Saturday 25 March 

Where: Dundee MakerSpace, 
Dundee, UK 

magpi.cc/2ktArof 

Get along to the Dundee 

MakerSpace and learn about the 

Raspberry Pi microcomputer! 


3RD ANNUAL HISAR Va ee, 


CODING SUMMIT 


PIGHRIGHIEDEVENTS REGULAR EVENTS 


PRESTON RASPBERRY JAM 

When: Monday 6 March 

Where: Media Innovation Studio, 
Preston, UK 

magpi.cc/21zZNExP 

A community of people who meet 

each month to learn, create, 

and share the potential of the 

Raspberry Pi computer. 


MANCHESTER 

RASPBERRY JAM 

When: Saturday 11 March 

Where: The Shed, Manchester, UK 
magpi.cc/2k476Wn 

Bring your Raspberry Pi along 
and take part in the workshops. 
There’s also a getting started 
session for newcomers. 
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HEAT MAP evERT WHERE 


CAN YOU HELP INCREASE 
THE AMOUNT OF JAMS 
DUNDEE IN THE AREAS THAT NEED MORE? 


RASPBERRY JAM 


BLAYDON 
RASPBERRY JAM 


MANCHESTER 
da * RASPBERRY JAM 
® 

« PRESTON 
RASPBERRY JAM 
) 

ih = 
4 > th x 
STAFFORD 
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¢) PI WARS 


STAFFORD 
RASPBERRY JAM 

When: Tuesday 14 March 

Where: Stafford Library, 

Stafford, UK 

magpi.cc/2lzwyQu 

A big meet-up of Pi enthusiasts 
7 who all share ideas, help each 


other, and most of all have fun! 


CODE CLUBS 


The latest figures show there 
are over 5,000 Code Club after- 
school or extracurricular clubs 
ground the UK, any of which 
you can join to learn more 
about computing. That means 
there's probably one near you. 
Code Clubs offer loads of fun 
ways to learn about computing 
using Scratch, Python, or 

even web-style code. Find out 
where your nearest one is at 
codeclub.org.uk. 


PI WARS 

When: Saturday 1 - Sunday 2 April 

Where: Computer Laboratory 
(University of Cambridge), 
Cambridge, UK 

magpi.cc/2k48U1D 

Pi Wars is back! The spin-off of the 

CamJam pits Pi-robots against each 

other in a series of tricky challenges. 
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Mature users 
Iam avery senior (more than 50 years’ 
experience) computer person from the USA. Iam 
also a physician health surveyor for Medicare, 
so I visit a lot of older folks, most of whom have 
been bypassed by the computer revolution. My 
experiments with Raspberry Pi indicate that this, 
in various form factors, could become a terrific 
introductory system for seniors who wish to learn 
about computing (and many of them do!). 

This is a HUGE potential application. I note 
that someone has already cobbled together 
a simplified user interface for seniors, though I 
personally would prefer that this be done at the 
OS level (I know, much easier said than done). On 
the whole, the Raspberry Pi is just taking off in the 
USA. It would be terrific if we could get something 
going with AARP to promote Raspberry Pi for the 
elderly, especially if we could produce a really 
EXCELLENT simple but capable user interface. 
Stuart Jones 


That’s great that it’s helping seniors learn 
about computing in America. The Raspberry Pi 
Foundation’s mission does really revolve around 
children, teens, and other young people, which 
is probably quite apparent in the way a lot of the 
resources are written. However, as you’ve said, the 
community has come together and created some 
interfaces more suited to seniors. There’s a very 
ong list of stuff that the PIXEL team has to tweak 
and add, so you may see something like that one 
day, but who knows when? 

Otherwise, it might be an idea to keep an eye on 
any new Picademy USA courses, so you can learn 
better how to educate others about the Raspberry Pi. 


et 


Come along to a Picademy in the USA 
and learn how to teach with Pi 
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Lost in translation 

I’ve noticed you’re doing a few translated editions 
now — the German version and the mini mags. 
You seem to have a great range of languages; 
however, I’d love to help you with translating 

it into another language. Do you have any plans 
for future translated editions? 

Marcus 


We do have plans for other translated versions of 

The MagPi, although we can’t really talk about which 
ones just yet until we’re absolutely sure they’ re going 
to happen. While we do appreciate members of the 
community offering their services, it’s a little tricky 
in many ways, because we’re a magazine and making 
sure the text is different but the design stays similar 
requires a lot of extra skills. Do let us know what 
languages you would like it translated to, though, 

as we can always try to get that on the plan. 


LETTERS 


A lot of 
you liked the big 
project from last 
issue and we're 
definitely planning 
to do more in 


the future 
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FROM THE FORUM: This was a weird one, but thanks to the folks on the 
. forums, we did realise what happened... 
To begin with, they’re supposed to say GPIO and not 
WH - N AN S C | | FOHN. You then wire up the cover to the listed GPIO 
ports to get them to light in the right order. Simple 
enough. What seems to have happened is that during 
the design process, the illustration we used which said 


GPIO was subject to some bug that changed each letter 


The Raspberry Pi Forum is a hotbed of to the previous one on the alphabet. 
conversations and problem-solving for the Due to the way the articles are checked, it was 
community = join in via raspberrypi.org/forums nearly impossible to notice this error. Now we 
know it’s a thing that might happen, though, we 
ather late, I know (or early for 2017): I’m looking at the can make sure it doesn’t again. We’re sorry for any 


Christmas tree project. On the image of the back of the tree confusion caused! 
card, what do the characters mean next to the lights? 


What does ‘FOHN’ mean next to the light number? There is also W R IT E TO U S 
‘FOHN /1’, and ‘FOHN 05’ appears twice. i ‘ 
ae > aPP Have you got something you'd like to say? 
Thanks, F , ‘ p 4 
fe Get in touch via magpi@raspberrypi.org or on The MagPi 
Jonesypeter 


section of the forum at: raspberrypi.org/forums 
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WD PIDRIVE NODE ZERO 
FOR RASPBERRY PI 
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Build your own mini DLNA + Samba file server, wireless mobile 
storage device, or a Pi MusicBox with local storage and more. 


Includes: 
* 314GB WD PiDrive, Raspberry Pi Zero, 
and custom adapter board 
¢ SD card with starter software 

¢ Mini HDMI adapter cable 


© WDLABS Learn more at wdlabs.wd.com/magpi55¢ 


Western Digital, WD, the WD | 
LLC, The term HDM| is a trad 
depending on operating e 


>, WDLabs, and the WDLabs logo ar 
k oF registered trademark of HDMI L 
ent. Product specifications subject 


d trademarks or trademarks of 
LLC in the United States and other 
ge without notice. Pictures shown 


Digital Corporation or its affiliates in the U.S. and/< 
ies, All other marks are the property of their respectiv 
y from actual product. © 2017 Western Digital 


ty Pi is a trademark of the Raspberry Pi Foundation. microSD is a trademark of SD-3C, 
orage capacity, one gigabyte = one billion bytes, Total accessible capacity varies 


£PiHut 


www.ThePiHut.com 


This issue we’ve reviewed 
the brand-new version of 
Kodi and we’ve also made a tutorial 
on how to make your own HTPC with 
it. This Kodi case is the ideal accessory 
for your home theatre, blending in 


perfectly with your other devices. 


Tell us by 27 March Simply email competition@raspberrypi.org 


for your chance to win! with your name, address, and answer! 


Terms & Conditions 

Competition closes on 27 March 2017. Prize is offered worldwide to participants aged 18 or over, except employees of the Raspberry Pi Foundation, the prize supplier, 
their families or friends. Winners will be notified by email after the draw date. By entering the competition, the winner consents to any publicity generated from the 
competition, in print and online. Participants agree to receive occasional newsletters from The MagPi magazine (unless otherwise stated upon entry). We don't like 


spam. Participants’ details will remain strictly confidential and won't be shared with third parties. Prizes are non-negotiable and no cash alternative will be offered. 
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BC electronics enclosures for 
building automation applications 


The possibilities are endless when you add a Raspberry Pi 

The new RPI-BC enclosure for Raspberry Pi computers is part of the well-established 
BC electronics enclosure range from Phoenix Contact. The BC range is ideally suited 
to building automation & loT applications, offering endless possibilities to expand the 


functionality of Raspberry Pi computers. 


For additional information call 0845 881 2222 or visit phoenixcontact.co.uk/RPIBC 


DGD OO GD GD OGD OO OD Likonrsc ODE 


INSPIRING INNOVATIONS 


Column THE FINAL WoRD 


MATT RICHARDSON 


Matt is Raspberry Pi’s US-based product evangelist. Before 
that, he was co-author of Getting Started with Raspberry Pi 
and a contributing editor at Make: magazine. 
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Matt Richardson on how the arrival of Zero W is perfectly timed for IoT 


ince the original Raspberry Pi Zero came 
out, I’ve seen many makers using it for 
connected home projects. Its size, low price, 
low power consumption, and software package 

have made it a great option, even if makers had 

to use a USB peripheral to add connectivity. Now 
that wireless LAN and Bluetooth connectivity are 
built into Raspberry Pi Zero W, it makes this mini 
computer platform even better suited for home 
Internet of Things projects. 

Let me get this out of the way first: ‘Internet 
of Things’, or ‘IoT’, has all the trappings of 
an overhyped buzzword. But even if the term 
Internet of Things doesn’t stick around very long, 
the concept of connected devices is here to stay 
for good. It’s a clear side effect of increasingly 
affordable wireless connectivity technology. 

It’s not just development boards that are becoming 
more connected. The consumer electronics devices 
that we buy for our homes are more likely to have 
wireless capabilities. Even a product as simple as 
a light bulb can be equipped with connectivity, so 
that you can control its intensity and colour with a 
mobile app or home automation platform. I recently 
connected our Google Home to our WeMo Smart 
Plugs so that I can control the lights in our home 
using my voice. Last week I was carrying a load of 
laundry into a dark bedroom. Being able to say “OK 
Google, turn the bedroom lights on” and having it 
instantly do just that was a magical moment. 

As makers and technology enthusiasts, we have 
even more power available to us. We benefit from 
affordable connectivity when it arrives on hardware 
platforms like Zero W, and can create the connected 
devices that we hope to see on store shelves one day. 
We also benefit from being able to interface with 
consumer-connected devices. For example, a simple 
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hack with a Raspberry Pi lets you use Amazon 

Dash buttons to control almost anything you want. 
(Dash buttons are usually used to order a particular 
product, such as laundry detergent, from Amazon 
with just a single press.) 


Advanced loT 


If you want to go beyond the basics, there are cloud- 
based platforms that let you manage many devices 
at once, and create intelligent alerts and actions. 
Many platforms are already Raspberry Pi-friendly, 
including the Particle Cloud, Initial State, Cayenne, 
and Resin.io. Each has its distinct advantages. For 
example, Initial State makes it really easy for you 

to create custom web-based dashboards to show 
you the state of your own sensors and internet- 
connected devices. 

And if you’re a beginner, there are platforms that 
make it easy to get started with connected devices. 
One in particular is called IFTTT, which stands for ‘If 
This, Then That’. It’s an easy-to-use service that lets 
you connect consumer and maker platforms together 
without needing to write any code. IFTTT can also go 
beyond your devices: it can interact with the news, 
weather, or even local government. In the first 
partnership of its kind, the City of Louisville, 
Kentucky recently announced that it’s now on IFTTT 
and sending real-time air quality data, which you can 
log or use to trigger your own projects. I hope that 
it’s just the beginning for loT partnerships like these. 

With all the recent developments in the Internet 
of Things realm, Raspberry Pi Zero W comes at 
the perfect time to offer affordable, portable, and 
connected computing power. The best part is that 
exploring IloT doesn’t mean that you need to go too 
far into uncharted territory... it’s still the same 
Raspberry Pi that you already know and love. 
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The MagP1 is the most exciting mag in tech today, boasting 
one of the biggest & most engaged audiences in the industry. 


serial Pi Plus 


RS232 serial communication board. 
Control your Raspberry Pi over RS232 
or connect to external serial 
accessories. 


Breakout P! Plus 


The Breakout Pi Plus is a useful 
and versatile prototyping expansion 
board for the Raspberry Pi 


ADC Differential PI 


8 channel 18 bit analogue to digital 
converter. I?C address selection 
allows you to add up to 32 analogue 
inputs to your Raspberry Pi. 


IO Pi Plus 


32 digital 5V inputs or outputs. I?C 
address selection allows you to stack 
up to 4 IO Pi Plus boards on your 
Raspberry Pi giving you 128 digital 
inputs or outputs. 


RTC Pi Plus 


Real-time clock with battery backup 
and 5V I?C level converter for adding 
external 5V I?C devices to your 
Raspberry Pi. 


1 Wire Pi Plus 


1-Wire® to I?C host interface with ESD 
protection diode and I?C address 
selection. 


electronics 


AISO 
available 
for the 
Pi Zero 


—S 


erry pi Kit 


FOR 


DUNMIES 


Build your own credit card 
sized computer 


Get started with Programming 
Set up a Media Center 
Make simple electronic circuits 
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Raspberry Pj board and Case 
Power Supply and HDMI Cable 
Pre-Programmed Memory Card 
Over 40 electronic Parts ; 
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Available in Europe 
Available for worldwide shipping at: through RS Components 


$89” £69” 


US DOLLARS EXCLUDING VAT 


Raspberry Pi is a registered trademark of the Raspberry Pi Foundation. 
For Dummies and the Dummies Man logo are trademarks or registered 
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